Créer un contact
POST
https://app.sendapp.ai/api/contacts
Crée (ou met à jour via upsert) un seul contact. Il doit avoir au moins un téléphone OU un e-mail. Les contacts existants avec le même téléphone/e-mail sont fusionnés (tags combinés, métadonnées fusionnées).
Réponses :
201 Created avec le contact créé — 403 si la limite de contacts du plan est atteinte — 422 si le téléphone et l'e-mail sont tous deux absents.Vous pouvez écrire les champs personnalisés dès la création avec
custom_fields, par nom, avec les mêmes règles que Modifier un contact : un nom inconnu ou une valeur non valide renvoient 422 et le contact n'est pas enregistré. Si le contact existe déjà, les valeurs envoyées remplacent celles enregistrées et les valeurs vides sont ignorées. Vous trouvez les noms des champs avec GET /api/contact-fields.Paramètres
9 · 3 obligatoires
apikey
obligatoire
Votre API Key (l'en-tête
X-API-Key fonctionne aussi).
name
facultatif
Nom complet, jusqu'à 255 caractères.
first_name
facultatif
Prénom. Avec
first_name et/ou last_name, le nom complet est composé à partir de ceux-ci (ils priment sur name).
last_name
facultatif
Nom de famille.
phone
obligatoire
Format international (ex. +393391234567). Obligatoire si l'e-mail est absent.
email
obligatoire
E-mail valide. Obligatoire si le téléphone est absent.
tags
facultatif
Tableau de chaînes ou chaîne séparée par des virgules (ex. "vip,newsletter").
metadata
facultatif
Objet JSON avec des champs personnalisés.
custom_fields
facultatif
Objet dont la clé est le NOM du champ personnalisé, p. ex.
{"Ville": "Rome", "Newsletter": true}. Chaque valeur est contrôlée selon le type du champ, comme dans Modifier un contact.
Besoin d'aide pour l'intégration ? info@sendapp.live