Crear contacto

Crea un contacto para el negocio autenticado. Todos los campos son opcionales; cualquier campo no reconocido se guarda en collected_data.

POST/api/external/v2/contacts

Autenticación

Este endpoint se autentica con una API key mediante la cabecera X-API-Key (formato ek_live_...), en lugar del token bearer del resto de la referencia.

Cuerpo de la solicitud

Parámetro	Tipo	Obligatorio	Descripción
`first_name`	String	Opcional	Nombre del contacto.
`last_name`	String	Opcional	Apellido del contacto.
`phone_number`	String	Opcional	Teléfono en formato E.164 sin '+' (solo dígitos, 6-15 caracteres).
`email`	String	Opcional	Correo electrónico del contacto.

Ejemplo de solicitud

bash

curl -X POST "https://eclectic-api-537143970188.us-central1.run.app/api/external/v2/contacts" \
  -H "X-API-Key: ek_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "John",
    "last_name": "Doe",
    "phone_number": "56912345678",
    "email": "john@doe.com",
    "rut": "12345678-9"
  }'

Ejemplo de respuesta

json

{
  "success": true,
  "contact_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "created": true
}

Notas

Cualquier campo adicional se almacena en collected_data del contacto.
Si se envía phone_number y ya existe un contacto con ese número, se devuelve el existente (created: false).
Posibles errores: 400 (validación), 401 (API key inválida o ausente).