Liste des champs personnalisés

GET https://app.sendapp.ai/api/contact-fields

Renvoie les champs personnalisés des contacts de votre compte (page Champs personnalisés), dans l'ordre où vous les voyez sur la page. Utilisez le name d'un champ pour écrire sa valeur sur un contact avec custom_fields dans Modifier un contact.

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 : réessayez après quelques secondes.

Paramètres

1 · 1 obligatoires

apikey obligatoire

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

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

Requête

curl 'https://app.sendapp.ai/api/contact-fields' \
  -H 'X-API-Key: YOUR_API_KEY'

<?php
$ch = curl_init('https://app.sendapp.ai/api/contact-fields');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_API_KEY'],
]);
echo curl_exec($ch);
curl_close($ch);

const res = await fetch('https://app.sendapp.ai/api/contact-fields', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
console.log(await res.json());

Réponse

{
  "status": "success",
  "total": 2,
  "types": ["input", "textarea", "number", "date", "select", "multiselect", "boolean", "url", "phone", "email", "ai"],
  "fields": [
    {
      "id": 12,
      "name": "City",
      "type": "input",
      "options": null,
      "ai_prompt": null,
      "show_in_list": true,
      "visible_to_ai": true,
      "is_required": false,
      "sort_order": 0,
      "created_at": "2026-10-29 10:00:00",
      "updated_at": "2026-10-29 10:00:00"
    },
    {
      "id": 13,
      "name": "Size",
      "type": "select",
      "options": ["S", "M", "L"],
      "ai_prompt": null,
      "show_in_list": false,
      "visible_to_ai": true,
      "is_required": true,
      "sort_order": 1,
      "created_at": "2026-10-29 10:05:00",
      "updated_at": "2026-10-29 10:05:00"
    }
  ]
}

{
  "status": "error",
  "message": "Your current plan does not include API access."
}