Actualizar contacto

PUT https://app.sendapp.ai/api/contacts/{id}

Actualiza uno o varios campos de un contacto. Solo se modifican las claves enviadas; tags SUSTITUYE el conjunto completo (usa los endpoints de etiquetas para añadir o quitar etiquetas sueltas). Cada cambio queda registrado en el historial del contacto. También acepta PATCH.

Parámetros

10 · 2 obligatorios

apikey obligatorio

Tu API Key (también sirve la cabecera X-API-Key).

id obligatorio

ID del contacto (entero, en la ruta). Usa GET /api/contacts para encontrarlo.

name opcional

Nombre del contacto.

phone opcional

Teléfono en formato internacional. 409 si ya pertenece a otro contacto.

email opcional

Dirección de email. 409 si ya pertenece a otro contacto.

birthday opcional

Fecha en formato YYYY-MM-DD (null para borrarla).

tags opcional

Array o cadena separada por comas — sustituye todas las etiquetas.

custom_fields opcional

Objeto cuya clave es el NOMBRE del campo personalizado, p. ej. {"Ciudad": "Madrid"}. Los nombres desconocidos devuelven 422. Envía null o "" para vaciar un valor.

opted_out opcional

true = excluir de las campañas, false = reactivar.

lifecycle_stage opcional

Uno de lead, qualified, customer, inactive, lost (null para borrarlo).

¿Necesitas ayuda con la integración? info@sendapp.live

curl -X PUT 'https://app.sendapp.ai/api/contacts/42' \ -H 'X-API-Key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "name": "Mario Rossi", "tags": ["cliente", "vip"], "custom_fields": { "City": "Milano" }, "lifecycle_stage": "customer" }'

<?php $ch = curl_init('https://app.sendapp.ai/api/contacts/42'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'PUT', CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_API_KEY', 'Content-Type: application/json'], CURLOPT_POSTFIELDS => json_encode(['name' => 'Mario Rossi', 'tags' => ['cliente', 'vip'], 'custom_fields' => ['City' => 'Milano'], 'lifecycle_stage' => 'customer']), ]); echo curl_exec($ch); curl_close($ch);

const res = await fetch('https://app.sendapp.ai/api/contacts/42', { method: 'PUT', headers: { 'X-API-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ name: 'Mario Rossi', tags: ['cliente', 'vip'], custom_fields: { City: 'Milano' }, lifecycle_stage: 'customer' }) }); console.log(await res.json());

{ "status": "success", "changed": ["name", "tags", "custom_fields", "lifecycle_stage"], "contact": { "id": 42, "name": "Mario Rossi", "tags": ["cliente", "vip"], "lifecycle_stage": "customer", "...": "..." } }