Referencia de la APIContactos
Listar
Obtén el listado paginado de los contactos de un cliente.
Descripción general
Este endpoint devuelve los contactos adicionales de un cliente, paginados y ordenados por fecha de creación, del más antiguo al más reciente. El tamaño de página es fijo en 20 resultados.
Los contactos son distintos del contacto principal del cliente (contact_name, contact_phone, contact_email y contact_second_email), que se consulta en Consultar cliente.
Requiere el permiso Leer en Clientes.
Endpoint
GET
https://app.credonix.mx/api/v1/customers/{customerId}/contactsPath param: customerId — el id del cliente.
Consulta los contactos de un cliente
Query params
| Parámetro | Tipo | Requerido | Default | Descripción |
|---|---|---|---|---|
page | integer ≥ 1 | No | 1 | Página solicitada. El tamaño de página es fijo en 20. |
Campos de la respuesta
| Campo | Tipo | Descripción |
|---|---|---|
id | string | Identificador del contacto. |
customer_id | string | id del cliente al que pertenece. |
name | string | Nombre del contacto. |
email | string | null | Correo. |
second_email | string | null | Segundo correo. |
phone | string | null | Teléfono en formato internacional. |
second_phone | string | null | Segundo teléfono. |
created_at | string | Fecha de creación (ISO 8601). |
updated_at | string | Fecha de la última actualización (ISO 8601). |
Errores
| Status | Código | Causa |
|---|---|---|
400 | INVALID_PAGE | page no es un número entero entre 1 y 107374183. |
403 | INSUFFICIENT_PERMISSIONS | La API key no tiene el permiso Leer en Clientes. |
404 | NOT_FOUND | El cliente no existe en esta organización. |