Crear contacto

Crea un nuevo contacto dentro de un workspace.

POST /workspaces/:workspaceId/contacts Copiar

Parámetros de ruta

Parámetro	Tipo	Descripción
workspaceId	string	Identificador del workspace (ej. ws_ab12cd34ef).

Cuerpo de la petición

Campo	Tipo	Requerido	Descripción
name	string	Sí	Nombre del contacto.
email	string	No	Correo electrónico.
phone	string	No	Teléfono en formato E.164.

Consejo

Usa el campo id de la respuesta para vincular el contacto a pipelines, eventos o campañas.

cURL

curl -X POST "https://api.waiify.com/workspaces/WORKSPACE_ID/contacts" \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Juan Pérez",
    "email": "juan@example.com",
    "phone": "+5215555555555"
  }'

Node

const res = await fetch(
  'https://api.waiify.com/workspaces/WORKSPACE_ID/contacts',
  {
    method: 'POST',
    headers: {
      Authorization: 'Bearer TU_API_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      name: 'Juan Pérez',
      email: 'juan@example.com',
      phone: '+5215555555555',
    }),
  }
);

const { data: contact } = await res.json();

Python

import requests

res = requests.post(
    "https://api.waiify.com/workspaces/WORKSPACE_ID/contacts",
    headers={"Authorization": "Bearer TU_API_KEY"},
    json={
        "name": "Juan Pérez",
        "email": "juan@example.com",
        "phone": "+5215555555555",
    },
)

contact = res.json()["data"]

Respuesta 201

{
  "success": true,
  "data": {
    "id": "contact_ab12cd34ef",
    "name": "Juan Pérez",
    "email": "juan@example.com",
    "phone": "+5215555555555",
    "createdAt": "2026-06-17T10:00:00.000Z"
  }
}