Ver contacto

GET/clients/{clientId}/contacts/{id}

Ficha completa de un contacto, con campos personalizados y origen de Meta.

Devuelve el contacto con sus campos personalizados y, si llegó por un anuncio de Meta, su campaña, conjunto, anuncio y formulario.

Autenticación

Cabecera Authorization: Bearer ack_live_…. Permiso necesario: contacts:read (o el de escritura). Cada llamada correcta consume créditos (créditos y límites).

Parámetros de la ruta

clientIduuidobligatorio

Id del cliente.

iduuidobligatorio

Id del contacto.

Respuestas

200Correcto. Consume créditos.

401UNAUTHORIZED · Falta el token o no es válido.

401TOKEN_REVOKED · El token se ha revocado.

401TOKEN_EXPIRED · El token ha caducado.

403PLAN_REQUIRED · La cuenta no tiene el plan Agentes ilimitados.

402NO_CREDITS · No quedan créditos en la cuenta.

429RATE_LIMITED · Más de 60 llamadas por minuto con el mismo token.

403FORBIDDEN_SCOPE · El token no tiene el permiso necesario.

404NOT_FOUND · El cliente no existe, no es tuyo o el token está limitado a otro cliente.

404NOT_FOUND · El contacto no existe en ese CRM.

Las respuestas de error no consumen créditos.

curl -X GET "https://agentclic.com/api/public/pro/v1/clients/3f1c2a8e-5b7d-4e19-9a62-0c4d8b7e1f20/contacts/8a2e4c61-1d3b-4f7a-b9e0-5c6d7e8f9a01" \
  -H "Authorization: Bearer ack_live_TU_TOKEN"

Respuesta200

{
  "contact": {
    "id": "8a2e4c61-1d3b-4f7a-b9e0-5c6d7e8f9a01",
    "name": "Lucía Martín",
    "email": "lucia@example.com",
    "phone": "+34600112233",
    "company": "Clínica Sol",
    "notes": "Viene del formulario de la web",
    "source": "api",
    "channel": "api",
    "stageId": "b7c1d2e3-4f50-4a61-8b72-9c83d4e5f601",
    "tags": [],
    "conversationId": null,
    "lastContactAt": null,
    "createdAt": "2026-11-03T10:15:00.000Z",
    "updatedAt": "2026-11-03T10:15:00.000Z",
    "customFields": [
      {
        "fieldId": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f",
        "value": "Implantes"
      }
    ],
    "origins": []
  }
}