Créer un champ personnalisé
POST
https://app.sendapp.ai/api/contact-fields
Crée un nouveau champ personnalisé pour les contacts, avec les mêmes règles que la page Champs personnalisés. Le champ est ajouté en fin de liste.
Réponses :
201 Created avec le champ créé — 409 si un champ du même nom existe déjà (sans distinction entre majuscules et minuscules) — 422 si une donnée n'est pas valide (le message liste les types valides).Types disponibles :
input, textarea, number, date, select, multiselect, boolean, url, phone, email, ai. options n'est renseigné que pour select et multiselect, ai_prompt que pour ai.Erreurs courantes :
401 si la clé API manque ou est erronée — 403 si le forfait a expiré ou n'inclut pas l'accès à l'API — 429 si vous envoyez trop de requêtes en peu de temps ou si une autre modification des champs personnalisés de votre compte est en cours : réessayez après quelques secondes.Paramètres
8 · 3 obligatoires
apikey
obligatoire
Votre API Key (l'en-tête
X-API-Key fonctionne aussi).
name
obligatoire
Nom du champ, jusqu'à 255 caractères. Il doit être unique dans votre compte : c'est le nom avec lequel vous écrivez la valeur sur un contact.
type
obligatoire
Type du champ :
input, textarea, number, date, select, multiselect, boolean, url, phone, email ou ai.
options
facultatif
Uniquement pour
select et multiselect (obligatoire) : tableau de choix, de 1 à 50, uniques, chacun jusqu'à 60 caractères. Une chaîne séparée par des virgules est aussi acceptée.
ai_prompt
facultatif
Uniquement pour
ai (obligatoire) : ce que l'IA doit extraire des conversations, jusqu'à 500 caractères.
show_in_list
facultatif
true pour l'afficher comme colonne dans la liste des contacts (false par défaut).
visible_to_ai
facultatif
true si l'assistant IA peut lire sa valeur (true par défaut).
is_required
facultatif
true pour le rendre obligatoire dans le formulaire du contact (false par défaut). Non autorisé pour les champs
ai.
Besoin d'aide pour l'intégration ? info@sendapp.live