SendApp Docs
Se connecter

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é.
Les noms des champs personnalisés, avec leur type et les choix autorisés, s'obtiennent avec GET /api/contact-fields.
Valeurs par type : oui/non true ou false (aussi 1/0, "yes"/"no"), enregistré comme 1/0 comme dans la page Contacts ; nombre un nombre (aussi "12,5") ; date YYYY-MM-DD (d'une date et heure ISO 8601 la date est conservée) ; choix unique l'un des choix ; choix multiple un tableau de choix ou un texte avec les choix séparés par des virgules. Pour les choix, majuscules et minuscules ne comptent pas : la valeur est enregistrée avec l'orthographe officielle. Une valeur non valide renvoie 422 avec invalid_fields, le motif pour chaque champ, et rien n'est modifié.
Les champs de type IA sont remplis par l'IA de SendApp : ils ne peuvent pas être écrits (422, dans invalid_fields), mais vous les lisez dans le contact, dans custom_fields.

Paramètres

18 · 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.
first_name facultatif
Prénom : le nom complet est recomposé (il prime sur name). Si le contact n'était pas encore divisé, l'autre moitié est reprise du nom actuel.
last_name facultatif
Nom de famille : le nom complet est recomposé.
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é, p. ex. {"Ville": "Rome"}. Chaque valeur est contrôlée selon le type du champ (voir les notes) : des noms inconnus ou des valeurs non valides renvoient 422. Envoyez null ou "" pour vider une valeur.
opted_out facultatif
true = exclure des campagnes, false = réinscrire.
requested_by facultatif
Avec opted_out=true : qui a demandé l'opt-out, contact (la personne, retrait du consentement ; c'est la valeur si le champ manque) ou business (votre décision, le consentement reste). Une autre valeur renvoie 422.
opt_out_reason facultatif
Avec opted_out=true : motif avec vos mots (191 caractères au maximum), enregistré dans l'historique du contact.
consent_ads facultatif
App «Conversioni pubblicitarie»: consenso del contatto alla misurazione degli annunci (comunicare a Meta il clic sull'annuncio e cosa ha fatto dopo). true = consenso raccolto dal tuo sistema (serve consent_ads_method, altrimenti 422), false = ritiro, vale subito anche per le conversioni in coda. Non è il consenso marketing.
consent_ads_method facultatif
Obbligatorio con consent_ads=true: come è stato raccolto il consenso, uno tra form, verbal, signature, email, other (con other serve anche consent_ads_text_ref).
consent_ads_text_ref facultatif
Versione o riferimento del testo che il contatto ha accettato (massimo 191 caratteri), per esempio informativa v3, modulo sito 2026-10.
ads_excluded facultatif
true = escludi il contatto dalle conversioni pubblicitarie (opposizione); separato da opted_out: i messaggi continuano.
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