Crear nuevo contacto

post

https://api-ws.wasapi.io/api/v1/contacts

Registra un nuevo contacto en el sistema con sus datos asociados

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Datos del contacto a registrar o actualizar

phone es obligatorio al crear un contacto, pero opcional al actualizarlo:
un contacto que oculta su número no tiene teléfono, y omitir el campo conserva el que
ya tenga (o lo deja vacío si no tiene). Enviar phone en una actualización sí lo
reemplaza.

Identificadores de un contacto que oculta su número

Campo	¿Se puede escribir?
`wa_username`	Sí. Omitirlo conserva el actual; enviarlo en `null` lo borra
`bsuid`	No. Es de solo lectura — ver abajo

⚠️ bsuid no se puede modificar. Lo asigna Meta y llega por webhook, así que no
hay un valor que usted pueda conocer por otra vía. Además es la clave de la
conversación cuando el contacto no tiene teléfono: cambiarlo dejaría su historial de
mensajes huérfano, apuntando al identificador anterior. Si lo envía en el cuerpo se
ignora, sin error.

Para identificar un contacto de forma estable use su uuid.

first_name

string

required

Nombre del contacto

last_name

string

Apellido del contacto

string

Dirección de correo electrónico del contacto

country_code

string

Código de país del contacto

phone

string | null

Número de teléfono del contacto. Obligatorio al crear (salvo que el contacto se
identifique por bsuid), opcional al actualizar.

wa_username

string | null

Username público de WhatsApp del contacto. Es el valor legible que identifica a
quien oculta su número, y sirve como destinatario en los endpoints de envío.

Se acepta tanto al crear como al actualizar. En una actualización,
omitirlo conserva el que ya tenga; para borrarlo hay que enviarlo
explícitamente en null.

⚠️ Devuelve 422 si otro contacto suyo ya tiene ese username: Wasapi lo usa para
reconocer que dos fichas son la misma persona, así que un duplicado deja preparada
una fusión de dos contactos distintos. Libere primero el username del otro contacto.

Es mutable y reasignable por su dueño en WhatsApp, así que sirve para
encontrar al contacto, nunca como su llave primaria — para eso está uuid.

notes

string

Información adicional relevante sobre el contacto

blocked

boolean

Defaults to false

Estado de bloqueo del contacto

unsubscribed

boolean

Defaults to false

Estado de suscripción del contacto

labels

array of integers

Lista de identificadores de etiquetas asociadas

labels

custom_fields

object

Campos personalizados a asignar al contacto, donde la clave es el nombre del campo y el valor es el valor a asignar

Responses

Identificadores de un contacto que oculta su número

200Contacto creado exitosamente

401Acceso no autorizado - Token inválido o no proporcionado

409Conflicto - Contacto duplicado

420Error de validación en los datos proporcionados