Modifier un contact

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

Modifie un ou plusieurs champs d'un contact. Seules les clés envoyées sont modifiées ; tags REMPLACE l'ensemble complet (utilisez les endpoints de tags pour en ajouter ou en retirer un seul). Chaque modification est enregistrée dans l'historique du contact. PATCH est aussi accepté.

Paramètres

10 · 2 obligatoires

apikey obligatoire

Votre API Key (l'en-tête X-API-Key fonctionne aussi).

id obligatoire

ID du contact (entier, dans le chemin). Utilisez GET /api/contacts pour le trouver.

name facultatif

Nom du contact.

phone facultatif

Téléphone au format international. 409 s'il appartient déjà à un autre contact.

email facultatif

Adresse e-mail. 409 si elle appartient déjà à un autre contact.

birthday facultatif

Date au format YYYY-MM-DD (null pour l'effacer).

tags facultatif

Tableau ou chaîne séparée par des virgules — remplace tous les tags.

custom_fields facultatif

Objet dont la clé est le NOM du champ personnalisé, par ex. {"Ville": "Paris"}. Les noms inconnus renvoient 422. Envoyez null ou "" pour vider une valeur.

opted_out facultatif

true = exclure des campagnes, false = réinscrire.

lifecycle_stage facultatif

L'une des valeurs lead, qualified, customer, inactive, lost (null pour l'effacer).

Besoin d'aide pour l'intégration ? 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", "...": "..." } }