Modifier un champ personnalisé

PUT https://app.sendapp.ai/api/contact-fields/{id}

Modifie un champ personnalisé. La mise à jour est partielle : les clés que vous n'envoyez pas restent telles quelles. PATCH est aussi accepté. Les valeurs déjà enregistrées sur les contacts sont conservées.

Vous pouvez aussi changer le type, avec les mêmes règles qu'à la création : pour passer à select/multiselect il faut des options (si le champ en avait déjà, elles restent), pour passer à ai il faut un ai_prompt et le champ cesse d'être obligatoire.

Réponses : 200 avec le champ et la liste changed des réglages modifiés — 404 si le champ n'appartient pas à votre compte — 409 si le nouveau nom est déjà utilisé par un autre champ — 422 si une donnée n'est pas valide.

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

9 · 2 obligatoires

apikey obligatoire

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

id obligatoire

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

name facultatif

Nouveau nom (unique dans votre compte).

type facultatif

Type du champ : input, textarea, number, date, select, multiselect, boolean, url, phone, email ou ai.

options facultatif

La liste complète des nouveaux choix (remplace la liste actuelle).

ai_prompt facultatif

Nouveau prompt (champs ai).

show_in_list facultatif

true pour l'afficher comme colonne dans la liste des contacts, false pour l'enlever. Si vous ne l'envoyez pas, il reste tel quel.

visible_to_ai facultatif

true si l'assistant IA peut lire sa valeur, false sinon. Si vous ne l'envoyez pas, il reste tel quel.

is_required facultatif

true pour le rendre obligatoire dans le formulaire du contact, false pour l'enlever. Si vous ne l'envoyez pas, il reste tel quel. Non autorisé pour les champs ai.

Besoin d'aide pour l'intégration ? info@sendapp.live

curl -X PATCH 'https://app.sendapp.ai/api/contact-fields/13' \ -H 'X-API-Key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "options": ["S", "M", "L", "XL"], "show_in_list": true }'

<?php $ch = curl_init('https://app.sendapp.ai/api/contact-fields/13'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'PATCH', CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_API_KEY', 'Content-Type: application/json'], CURLOPT_POSTFIELDS => json_encode(['options' => ['S', 'M', 'L', 'XL'], 'show_in_list' => true]), ]); echo curl_exec($ch); curl_close($ch);

const res = await fetch('https://app.sendapp.ai/api/contact-fields/13', { method: 'PATCH', headers: { 'X-API-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ options: ['S', 'M', 'L', 'XL'], show_in_list: true }) }); console.log(await res.json());

{ "status": "success", "message": "Field updated.", "changed": ["options", "show_in_list"], "field": { "id": 13, "name": "Size", "type": "select", "options": ["S", "M", "L", "XL"], "show_in_list": true, "...": "..." } }