Skip to main content
POST
/
api
/
contacts
curl -X POST https://app.horneross.com/api/contacts \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "nuevo@ejemplo.com",
    "firstName": "Carlos",
    "lastName": "López",
    "phoneNumber": "+5491198765432"
  }'

{
  "id": "contact_new789",
  "email": "nuevo@ejemplo.com",
  "phoneNumber": "+5491198765432",
  "firstName": "Carlos",
  "lastName": "López",
  "instagramId": null,
  "organizationId": "org_xyz",
  "createdAt": "2024-01-21T16:00:00Z",
  "updatedAt": "2024-01-21T16:00:00Z"
}

​
Endpoint

POST /api/contacts
Creá un nuevo contacto manualmente.

​
Headers

​
Authorization
string
required
Bearer token con tu API key. Formato: Bearer sk_live_xxx
​
Content-Type
string
required
Siempre application/json

​
Request Body

​
email
string
Email del contacto. Debe ser un email válido o string vacío.
​
phoneNumber
string
Número de teléfono con código de país (ej: +5491123456789)
​
firstName
string
Nombre del contacto
​
lastName
string
Apellido del contacto
​
conversationId
string
ID de conversación existente para vincular el contacto
​
instagramId
string
ID de Instagram del usuario
curl -X POST https://app.horneross.com/api/contacts \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "nuevo@ejemplo.com",
    "firstName": "Carlos",
    "lastName": "López",
    "phoneNumber": "+5491198765432"
  }'

​
Response

​
id
string
required
ID único del contacto creado
​
email
string
Email del contacto
​
phoneNumber
string
Número de teléfono
​
firstName
string
Nombre
​
lastName
string
Apellido
​
organizationId
string
required
ID de la organización
​
createdAt
string
required
Fecha de creación (ISO 8601)
{
  "id": "contact_new789",
  "email": "nuevo@ejemplo.com",
  "phoneNumber": "+5491198765432",
  "firstName": "Carlos",
  "lastName": "López",
  "instagramId": null,
  "organizationId": "org_xyz",
  "createdAt": "2024-01-21T16:00:00Z",
  "updatedAt": "2024-01-21T16:00:00Z"
}

​
Vincular a conversación

Para vincular un contacto a una conversación existente: 
const response = await fetch('https://app.horneross.com/api/contacts', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sk_live_xxx',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    email: 'cliente@ejemplo.com',
    firstName: 'Ana',
    conversationId: 'conv_xyz123', // Vincular a conversación
  }),
});