Contactos

Un contacto es una persona que respondió el formulario de un anuncio en la red. Llega solo: no hace falta el Datil Pixel. status es new , contacted , qualified o disqualified . Cada envío nuevo también sale por los webhooks de anuncios como lead.created .

Listar contactos#

GET /api/v1/leads Bearer

De la más antigua a la más reciente, por páginas: limit (1 a 100, 25 por defecto) y after (el next_cursor de la página anterior).

Parámetros

limit integer

Cuántos por página, de 1 a 100.

after string

El next_cursor de la página anterior.

Devuelve · 200 con la lista ( data , has_more , next_cursor ) · 422 con un filtro inválido.

cURL

curl "https://edge.datil.com/api/v1/leads" \
  -H "Authorization: Bearer $DATIL_API_KEY"

Respuesta · 200

{
  "object": "list",
  "data": [
    {
      "id": "9b0c1d2e-3f4a-4b5c-8d6e-7f8a9b0c1d2e",
      "object": "lead",
      "campaign_id": "3b4c5d6e-7f8a-4b9c-8d0e-2f3a4b5c6d7e",
      "network": "meta",
      "name": "Ana Ruiz",
      "email": "ana@example.com",
      "phone": "+593999000111",
      "company": null,
      "answers": {
        "full_name": "Ana Ruiz",
        "email": "ana@example.com"
      },
      "status": "new",
      "occurred_at": "2026-10-03T15:04:05Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Cambiar el estado de un contacto#

PATCH /api/v1/leads/:id Bearer

Registra si ya se le escribió, si califica o si se descarta.

Content-Type: application/json

Parámetros

id string requerido

El id del contacto.

Cuerpo de la solicitud

status string requerido

new , contacted , qualified o disqualified .

Devuelve · 200 con el contacto · 404 not_found · 422 .

cURL

curl -X PATCH https://edge.datil.com/api/v1/leads/7b0f6a52-3c1e-4d7e-9a57-0c1f5c2e9b10 \
  -H "Authorization: Bearer $DATIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "status": "qualified"
}'

Respuesta · 200

{
  "id": "9b0c1d2e-3f4a-4b5c-8d6e-7f8a9b0c1d2e",
  "object": "lead",
  "campaign_id": "3b4c5d6e-7f8a-4b9c-8d0e-2f3a4b5c6d7e",
  "network": "meta",
  "name": "Ana Ruiz",
  "email": "ana@example.com",
  "phone": "+593999000111",
  "company": null,
  "answers": {
    "full_name": "Ana Ruiz",
    "email": "ana@example.com"
  },
  "status": "new",
  "occurred_at": "2026-10-03T15:04:05Z"
}

Listar contactos#

Cambiar el estado de un contacto#

Cookies