Crea campo personalizzato

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

Crea un nuovo campo personalizzato per i contatti, con le stesse regole della pagina Campi personalizzati. Il campo viene aggiunto in fondo all'elenco.

Risposte: 201 Created con il campo creato — 409 se esiste già un campo con lo stesso nome (senza distinzione tra maiuscole e minuscole) — 422 se un dato non è valido (il messaggio elenca i tipi validi).

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 oppure se un'altra modifica ai campi personalizzati del tuo account è in corso: riprova dopo qualche secondo.

Parametri

8 · 3 obbligatori

apikey obbligatorio

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

name obbligatorio

Nome del campo, fino a 255 caratteri. Deve essere unico nel tuo account: è il nome con cui scrivi il valore su un contatto.

type obbligatorio

Tipo del campo: input, textarea, number, date, select, multiselect, boolean, url, phone, email o ai.

options opzionale

Solo per select e multiselect (obbligatorio): array di scelte, da 1 a 50, uniche, ognuna fino a 60 caratteri. Accetta anche una stringa separata da virgole.

ai_prompt opzionale

Solo per ai (obbligatorio): cosa deve ricavare l'AI dalle conversazioni, fino a 500 caratteri.

show_in_list opzionale

true per mostrarlo come colonna nell'elenco dei contatti (default false).

visible_to_ai opzionale

true se l'assistente AI può leggerne il valore (default true).

is_required opzionale

true per renderlo obbligatorio nel modulo del contatto (default false). Non ammesso per i campi ai.

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

curl -X POST 'https://app.sendapp.ai/api/contact-fields' \ -H 'X-API-Key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "name": "Size", "type": "select", "options": ["S", "M", "L"], "is_required": true }'

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

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

{ "status": "success", "message": "Field created.", "field": { "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" } }