Crear un contacto

Hoy la API incluye una sola acción: crear o actualizar un contacto. Usa la misma ruta de actualización que cualquier CRM conectado, así que las ediciones del dueño siguen teniendo prioridad y los contactos existentes se emparejan en lugar de duplicarse.

Requiere autenticación.

Solicitud

POST /api/v1/contacts

Si ya existe un contacto con ese número de teléfono, se actualiza. Si no, se crea uno nuevo, lo cual también dispara el evento de webhook new_contact.

Ejemplo:

curl -X POST https://app.rankladder.app/api/v1/contacts \
  -H "Authorization: Bearer rl_zapier_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone": "+15035551234", "name": "Sam Alvarez", "email": "sam@example.com"}'

Respuesta

{
  "action": "inserted",
  "contact_id": "b2c3d4e5-0000-4000-8000-000000000000"
}

action es inserted cuando se creó un contacto nuevo, updated cuando se emparejó con un contacto existente, o skipped cuando el contacto no pudo escribirse (un campo reason explica el motivo).

Errores