Crea contatto
POST
https://app.sendapp.ai/api/contacts
Crea (o aggiorna in upsert) un singolo contatto. Deve avere almeno un telefono OPPURE una email. Contatti esistenti con lo stesso telefono/email vengono uniti (tag combinati, metadata uniti).
Risposte:
201 Created con il contatto creato — 403 se raggiunto il limite di contatti del piano — 422 se mancano sia telefono che email.Puoi scrivere i campi personalizzati già alla creazione con
custom_fields, per nome, con le stesse regole di Aggiorna contatto: un nome sconosciuto o un valore non valido restituiscono 422 e il contatto non viene salvato. Se il contatto esiste già, i valori inviati sostituiscono quelli salvati e i valori vuoti vengono ignorati. I nomi dei campi li trovi con GET /api/contact-fields.Parametri
9 · 3 obbligatori
apikey
obbligatorio
La tua API Key (anche header
X-API-Key).
name
opzionale
Nome completo, fino a 255 caratteri.
first_name
opzionale
Nome di battesimo. Con
first_name e/o last_name il nome completo viene composto da questi (hanno la precedenza su name).
last_name
opzionale
Cognome.
phone
obbligatorio
Formato internazionale (es. +393391234567). Obbligatorio se manca email.
email
obbligatorio
Email valida. Obbligatoria se manca il telefono.
tags
opzionale
Array di stringhe o stringa separata da virgole (es. "vip,newsletter").
metadata
opzionale
Oggetto JSON con campi personalizzati.
custom_fields
opzionale
Oggetto con chiave = NOME del campo personalizzato, es.
{"Città": "Roma", "Newsletter": true}. Ogni valore viene controllato secondo il tipo del campo, come in Aggiorna contatto.
Serve aiuto con l'integrazione? info@sendapp.live