Data-API: Datensätze anlegen
Neue Einträge per POST übermitteln – etwa aus einem externen Formular, einer App oder einem Automatisierungs-Workflow.
Mit einem Token mit Scope data:<handle>:write legst du neue Einträge an. Sie entstehen immer als Entwurf und müssen im Dashboard veröffentlicht werden.
Anfrage
curl -X POST "https://<dashboard-domain>/api/data/anfragen" \
-H "Authorization: Bearer $ARETIS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Max Beispiel",
"email": "[email protected]",
"nachricht": "Ich interessiere mich für ein Angebot."
}'Die Schlüssel im Body sind die Feldkennungen deines Datentyps. Unbekannte Schlüssel werden ignoriert.
Antwort
| Status | Bedeutung |
|---|---|
201 | Eintrag angelegt, Antwort enthält { "stats": … } |
400 | invalid JSON body |
401 / 403 | Token fehlt, ist ungültig oder hat keinen Schreib-Scope |
404 | Datentyp nicht gefunden |
422 | Validierung fehlgeschlagen, z. B. Pflichtfeld fehlt oder Format falsch – mit Fehlermeldung |
429 | Rate-Limit (120 Anfragen / 60 s pro Unternehmen) |
Gut zu wissen
Pflichtfelder, Eindeutigkeit und Formatregeln des Datentyps gelten auch über die API.
Pro Anfrage wird ein Eintrag angelegt. Für große Datenmengen nutze den Import-Assistenten.
Das Anlegen löst den Webhook
record.createdaus, falls eingerichtet.
Willst du Einsendungen eines Website-Formulars speichern, brauchst du keine API: Nutze die Datensatz-Bindung des Formulars.
Unser Support antwortet in der Regel innerhalb eines Werktags.