Crear contacto
POST
https://app.sendapp.ai/api/contacts
Crea (o actualiza con upsert) un solo contacto. Debe tener al menos un teléfono O un email. Los contactos existentes con el mismo teléfono/email se fusionan (etiquetas combinadas, metadata fusionada).
Respuestas:
201 Created con el contacto creado — 403 si se alcanza el límite de contactos del plan — 422 si faltan tanto el teléfono como el email.Puedes escribir los campos personalizados ya al crear el contacto con
custom_fields, por nombre, con las mismas reglas que Actualizar contacto: un nombre desconocido o un valor no válido devuelven 422 y el contacto no se guarda. Si el contacto ya existe, los valores enviados sustituyen a los guardados y los valores vacíos se ignoran. Los nombres de los campos los encuentras con GET /api/contact-fields.Parámetros
9 · 3 obligatorios
apikey
obligatorio
Tu API Key (también sirve la cabecera
X-API-Key).
name
opcional
Nombre completo, hasta 255 caracteres.
first_name
opcional
Nombre de pila. Con
first_name y/o last_name el nombre completo se compone a partir de ellos (tienen prioridad sobre name).
last_name
opcional
Apellido.
phone
obligatorio
Formato internacional (p. ej. +393391234567). Obligatorio si falta el email.
email
obligatorio
Email válido. Obligatorio si falta el teléfono.
tags
opcional
Array de cadenas o cadena separada por comas (p. ej. "vip,newsletter").
metadata
opcional
Objeto JSON con campos personalizados.
custom_fields
opcional
Objeto con clave = NOMBRE del campo personalizado, p. ej.
{"Ciudad": "Roma", "Newsletter": true}. Cada valor se comprueba según el tipo del campo, como en Actualizar contacto.
¿Necesitas ayuda con la integración? info@sendapp.live