Contacts

Crear, listar y leer las personas que escriben a tu equipo.

GET/v1/contactscontacts:read

Lista los contactos del workspace, más recientes primero.

Campo	Tipo	Descripción
`q`	string	Filtra por nombre o email.
`limit`	number	1 a 100. Por defecto 25.
`cursor`	string	Id del último elemento de la página anterior.

POST/v1/contactscontacts:write

Crea un contacto. Devuelve 409 si ya existe uno con ese email.

Campo	Tipo	Descripción
`name`requerido	string	Nombre completo.
`email`requerido	string	Email único dentro del workspace.
`phone`	string	Teléfono en formato libre.
`company`	string	Empresa a la que pertenece.
`country`	string	País. Por defecto "Argentina".
`tags`	string[]	Etiquetas para segmentar.
`custom_fields`	object	Pares clave/valor con datos de tu sistema.

GET/v1/contacts/{id}contacts:read

Devuelve un contacto con sus conversaciones y tickets asociados.

Crear un contacto

curl -X POST https://api.tinkay.app/v1/contacts \  -H "Authorization: Bearer dk_live_xxx" \  -H "Content-Type: application/json" \  -d '{    "name": "Camila Rodríguez",    "email": "[email protected]",    "company": "Kipu Pagos",    "tags": ["business"],    "custom_fields": { "plan": "Business", "mrr": 399 }  }'

Respuesta

JSON

{  "data": {    "id": "ct_8f2a91",    "object": "contact",    "name": "Camila Rodríguez",    "email": "[email protected]",    "company": "Kipu Pagos",    "country": "Argentina",    "city": "Córdoba",    "tags": ["experto"],    "lifecycle": "customer",    "vip": false,    "source": "api",    "created_at": "2026-09-02T14:21:08.412Z",    "last_seen_at": "2026-09-02T14:21:08.412Z",    "conversations_count": 0,    "tickets_count": 0,    "custom_fields": { "plan": "Experto", "mrr": 119900 }  }}

El email es la clave de deduplicación. Si ya existe, la respuesta 409 incluye error.contact_id para que actualices en lugar de duplicar.