ZEVRACentro de Ayuda
IntegracionesAPI de captación

Referencia

El endpoint POST /v1/leads completo, generado desde la especificación OpenAPI.

Esta página se genera desde la especificación OpenAPI que publica la propia API en https://api.zevra.co/v1/openapi.json. Los ejemplos de código no se ejecutan desde aquí: la API es de servidor a servidor y no responde al navegador.

POST/v1/leads

Autenticación

bearerKey
AutenticaciónBearer <llave>

La llave del origen (canal API en Captación). Se muestra una sola vez al generarla. Nunca la pongas en JavaScript del navegador.

En: header

Cabeceras

Idempotency-Key?string

Identificador único de esta solicitud (1 a 200 caracteres ASCII imprimibles), por ejemplo el id del envío en tu formulario. Un reintento con la misma llave y el mismo cuerpo devuelve la respuesta original con replay: true durante 24 horas. Una solicitud fallida libera la llave. Se ignora en una simulación.

Longitud1 <= length <= 200
X-Zevra-Dry-Run?"true"

Con el valor true, la API valida, resuelve la propiedad y busca coincidencias, pero no escribe nada. Responde 200 con status: dry_run.

Valor en

  • "true"

Cuerpo de la solicitud

application/json

Tipos en TypeScript

Usa el tipo request body en TypeScript.

Cuerpo de POST /v1/leads.

Cuerpo de la respuesta

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/leads" \  -H "Content-Type: application/json" \  -d '{    "nombre": "Ana Ruiz"  }'
{  "lead_id": "315f3db3-7c1e-4d2a-9b8f-0a1b2c3d4e5f",  "status": "enriched",  "matched_on": "telefono",  "lead_url": "https://dashboard.zevra.co/dashboard/leads?leadId=315f3db3-7c1e-4d2a-9b8f-0a1b2c3d4e5f",  "request_id": "req_8f3a2c1d9e4b7a6c5d2e1f0a",  "replay": true}