Elenco campi personalizzati

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

Restituisce i campi personalizzati dei contatti del tuo account (pagina Campi personalizzati), nell'ordine in cui li vedi nella pagina. Usa il name di un campo per scriverne il valore su un contatto con custom_fields in Aggiorna contatto.

Tipi disponibili: input, textarea, number, date, select, multiselect, boolean, url, phone, email, ai. options è valorizzato solo per select e multiselect, ai_prompt solo per ai.

Errori comuni: 401 se la chiave API manca o è sbagliata — 403 se il piano è scaduto o non include l'accesso API — 429 se fai troppe richieste in poco tempo: riprova dopo qualche secondo.

Parametri

1 · 1 obbligatori

apikey obbligatorio

La tua API Key (anche header X-API-Key).

Serve aiuto con l'integrazione? info@sendapp.live

Richiesta

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());

Risposta

{
  "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."
}