curl --request POST \
  --url https://app.eltick.com/api/v1/contacts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone": "+52 55 1234 5678",
  "name": "Ximena Robles",
  "tags": [
    "tienda-online",
    "vip"
  ],
  "attributes": {
    "ciudad": "Ciudad de México",
    "ultima_compra": "2026-09-20"
  }
}
'

{
  "id": "01a0d467-e634-7f7f-b98b-bdb48431733e",
  "phone": "525512345678",
  "name": "Ximena Robles",
  "tags": [
    "tienda-online",
    "vip"
  ],
  "attributes": {
    "ciudad": "Ciudad de México",
    "total_gastado": "45000",
    "ultima_compra": "2026-09-20"
  },
  "optedOut": false,
  "marketingOptOut": false,
  "createdAt": "2026-09-24T17:12:54.068Z"
}

Contactos

Crear o actualizar un contacto

Crea el contacto si el teléfono no existe en la cuenta, o lo actualiza si ya existe (responde 201 o 200 según el caso).

Al actualizar:

name y tags se reemplazan solo si los mandas. Ojo: tags reemplaza la lista completa.
attributes se combina con los que ya tenía: solo cambian las claves que mandas.
Si un atributo no existe como campo en la cuenta, se crea como campo de texto y ya queda disponible para filtrar y como variable en las plantillas.

Cuando el contacto es nuevo se dispara el webhook contact.created.

POST

/

contacts

curl --request POST \
  --url https://app.eltick.com/api/v1/contacts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone": "+52 55 1234 5678",
  "name": "Ximena Robles",
  "tags": [
    "tienda-online",
    "vip"
  ],
  "attributes": {
    "ciudad": "Ciudad de México",
    "ultima_compra": "2026-09-20"
  }
}
'

{
  "id": "01a0d467-e634-7f7f-b98b-bdb48431733e",
  "phone": "525512345678",
  "name": "Ximena Robles",
  "tags": [
    "tienda-online",
    "vip"
  ],
  "attributes": {
    "ciudad": "Ciudad de México",
    "total_gastado": "45000",
    "ultima_compra": "2026-09-20"
  },
  "optedOut": false,
  "marketingOptOut": false,
  "createdAt": "2026-09-24T17:12:54.068Z"
}

Autorizaciones

Authorization

string

header

requerido

Tu clave de API. La creas en Ajustes › API y webhooks de app.eltick.com. Mándala en el encabezado Authorization: Bearer etk_live_….

Cuerpo

application/json

phone

string

requerido

Teléfono con código de país. Acepta espacios y guiones: +54 9 11 2345-6789, +52 55 1234 5678, +57 300 123 4567.

Required string length: 6 - 32

name

string

Maximum string length: 120

tags

string[]

Reemplaza todas las etiquetas del contacto.

Maximum array length: 20

Maximum string length: 40

attributes

object

Se combinan con los atributos que ya tenía. Los valores siempre son texto.

Show child attributes

Respuesta

El contacto ya existía y se actualizó.

id

string<uuid>

requerido

phone

string | null

requerido

Teléfono en formato internacional, sin + (el formato de WhatsApp). null en contactos que solo te escribieron por Instagram.

Ejemplo:

"5491155550101"

name

string | null

requerido

tags

string[]

requerido

attributes

object

requerido

Campos personalizados del contacto (ciudad, último pedido, etc.).

Show child attributes

optedOut

boolean

requerido

Pidió no recibir más mensajes. No le llegan campañas.

marketingOptOut

boolean

requerido

Meta bloquea los mensajes de marketing para este número (por ejemplo, porque dejó de aceptarlos en WhatsApp).

createdAt

string<date-time>

requerido