Benutzerdefiniertes Feld erstellen
POST
https://app.sendapp.ai/api/contact-fields
Erstellt ein neues benutzerdefiniertes Kontaktfeld, mit denselben Regeln wie die Seite Benutzerdefinierte Felder. Das Feld wird am Ende der Liste angefügt.
Antworten:
201 Created mit dem erstellten Feld — 409, wenn bereits ein Feld mit demselben Namen existiert (ohne Unterscheidung von Groß- und Kleinschreibung) — 422, wenn ein Wert ungültig ist (die Meldung nennt die gültigen Typen).Verfügbare Typen:
input, textarea, number, date, select, multiselect, boolean, url, phone, email, ai. options ist nur bei select und multiselect gesetzt, ai_prompt nur bei ai.Häufige Fehler:
401, wenn der API-Schlüssel fehlt oder falsch ist — 403, wenn der Tarif abgelaufen ist oder keinen API-Zugang enthält — 429, wenn du in kurzer Zeit zu viele Anfragen sendest oder gerade eine andere Änderung an den benutzerdefinierten Feldern deines Kontos läuft: versuche es nach ein paar Sekunden erneut.Parameter
8 · 3 Pflichtfelder
apikey
erforderlich
Ihr API Key (der Header
X-API-Key funktioniert ebenfalls).
name
erforderlich
Feldname, bis zu 255 Zeichen. Er muss in deinem Konto eindeutig sein: Unter diesem Namen schreibst du den Wert auf einen Kontakt.
type
erforderlich
Feldtyp:
input, textarea, number, date, select, multiselect, boolean, url, phone, email oder ai.
options
optional
Nur für
select und multiselect (Pflicht): Array von Auswahlwerten, 1 bis 50, eindeutig, je bis zu 60 Zeichen. Auch eine kommagetrennte Zeichenkette wird akzeptiert.
ai_prompt
optional
Nur für
ai (Pflicht): was die KI aus den Gesprächen ermitteln soll, bis zu 500 Zeichen.
show_in_list
optional
true, um es als Spalte in der Kontaktliste anzuzeigen (Standard false).
visible_to_ai
optional
true, wenn der KI-Assistent den Wert lesen darf (Standard true).
is_required
optional
true, um es im Kontaktformular zur Pflicht zu machen (Standard false). Für
ai-Felder nicht erlaubt.
Brauchen Sie Hilfe bei der Integration? info@sendapp.live