Referencia de la APIContactos
Crear
Agrega un contacto a un cliente.
Descripción general
Este endpoint agrega un contacto a un cliente, con las mismas reglas que el formulario de la aplicación. El único campo obligatorio es name. Una solicitud exitosa devuelve 201 con el contacto creado.
El cuerpo se valida antes de buscar al cliente: un cuerpo inválido responde 400 aunque el cliente no exista.
Acepta el header Idempotency-Key para reintentar sin crear contactos duplicados (ver Idempotencia).
Requiere el permiso Crear en Clientes.
Endpoint
POST
https://app.credonix.mx/api/v1/customers/{customerId}/contactsPath param: customerId — el id del cliente.
Solicitud
Envía el nombre y los datos de contacto. Los teléfonos van en formato internacional.
{
"name": "Laura Méndez Ríos",
"email": "[email protected]",
"phone": "+525512345678"
}Reglas de los campos
| Campo | Tipo | Requerido | Notas |
|---|---|---|---|
name | string | Sí | No puede ser vacío. |
email, second_email | string | null | No | Correo válido o "". |
phone, second_phone | string | null | No | Teléfono válido en formato internacional (por ejemplo +525512345678) o "". |
No se aceptan campos adicionales.
Errores
400 — validación fallida
{
"code": "VALIDATION_ERROR",
"message": "La petición contiene datos inválidos. Revisa errors para ver el detalle de cada campo.",
"errors": [
{
"field": "phone",
"code": "invalid_union",
"message": "Entrada inválida"
}
],
"request_id": "f973571e-eff2-42d8-b77c-64a812098eb6"
}| Status | Código | Causa |
|---|---|---|
400 | VALIDATION_ERROR | Falta name, un correo o teléfono no es válido o se envió un campo desconocido. |
403 | INSUFFICIENT_PERMISSIONS | La API key no tiene el permiso Crear en Clientes. |
404 | NOT_FOUND | El cliente no existe en esta organización. |