curl --request POST \
--url 'https://management.scanova.io/forms/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Booth Signup",
"data": {
"fields": [
{ "type": "text", "label": "Full name", "required": true },
{ "type": "email", "label": "Email", "required": true }
]
}
}'
{
"id": 376,
"form_id": "F8a9b0c1d2e3f4g5h",
"name": "Booth Signup",
"created_by": "Docs",
"created": "2026-08-16T20:46:12.554000+05:30",
"form_url": "https://new.scnv.io/form/F8a9b0c1d2e3f4g5h",
"is_active": true,
"usage_count": 0,
"linked_qrs": [],
"entries_count": 0,
"conversion": null,
"modified": "2026-08-16T20:46:12.554000+05:30",
"data": {
"fields": [
{ "type": "text", "label": "Full name", "required": true },
{ "type": "email", "label": "Email", "required": true }
]
},
"theme_id": null,
"theme_config": {},
"theme_overrides": null
}
Management-API — Leads & Formulare
Ein Formular erstellen
POST /forms/
POST
/
forms
/
curl --request POST \
--url 'https://management.scanova.io/forms/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Booth Signup",
"data": {
"fields": [
{ "type": "text", "label": "Full name", "required": true },
{ "type": "email", "label": "Email", "required": true }
]
}
}'
{
"id": 376,
"form_id": "F8a9b0c1d2e3f4g5h",
"name": "Booth Signup",
"created_by": "Docs",
"created": "2026-08-16T20:46:12.554000+05:30",
"form_url": "https://new.scnv.io/form/F8a9b0c1d2e3f4g5h",
"is_active": true,
"usage_count": 0,
"linked_qrs": [],
"entries_count": 0,
"conversion": null,
"modified": "2026-08-16T20:46:12.554000+05:30",
"data": {
"fields": [
{ "type": "text", "label": "Full name", "required": true },
{ "type": "email", "label": "Email", "required": true }
]
},
"theme_id": null,
"theme_config": {},
"theme_overrides": null
}
Formulare sind Scanovas aktueller Builder für Lead-Erfassung und Datensammlung — umfangreicher als die veraltete Funktion Lead-Listen und der empfohlene Weg, um Besucherdaten aus einem QR-Scan zu erfassen. Listen Sie sie hier auf oder erstellen Sie neue.
Erfordert einen Management-API-Schlüssel mit
MANAGEMENT_API- (oder MANAGEMENT_API_SANDBOX-)Quota, gesendet als roher Authorization-Header-Wert — siehe die Management-API-Übersicht.curl --request POST \
--url 'https://management.scanova.io/forms/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Booth Signup",
"data": {
"fields": [
{ "type": "text", "label": "Full name", "required": true },
{ "type": "email", "label": "Email", "required": true }
]
}
}'
{
"id": 376,
"form_id": "F8a9b0c1d2e3f4g5h",
"name": "Booth Signup",
"created_by": "Docs",
"created": "2026-08-16T20:46:12.554000+05:30",
"form_url": "https://new.scnv.io/form/F8a9b0c1d2e3f4g5h",
"is_active": true,
"usage_count": 0,
"linked_qrs": [],
"entries_count": 0,
"conversion": null,
"modified": "2026-08-16T20:46:12.554000+05:30",
"data": {
"fields": [
{ "type": "text", "label": "Full name", "required": true },
{ "type": "email", "label": "Email", "required": true }
]
},
"theme_id": null,
"theme_config": {},
"theme_overrides": null
}
string
erforderlich
Formularname.
object
erforderlich
Das Feldschema des Formulars — wird gegen das JSON-Schema des Scanova-Formular-Builders validiert. Fehlerhafte Daten geben einen 400-Fehler unter
data zurück.string
Die
qrid eines QR-Codes, der bei der Erstellung sofort angehängt werden soll. Gilt nur für dynamische (dy) QR-Codes.integer
Die ID eines aktiven Themes, um die öffentliche Seite des Formulars zu gestalten. Weglassen für das Plattform-Standarddesign.
object
Partielle Theme-Token-Overrides, die über
theme_id (oder das Standard-Theme) gelegt werden.Das nachträgliche Verknüpfen mit weiteren QR-Codes oder das vollständige Ersetzen der Verknüpfungsmenge ist nicht Teil des Request-Bodys dieses Endpunkts — das ist eine separate
qr_ids-Verknüpfungsersetzungs-Aktion, die im Dashboard/in der internen API verfügbar ist, hier jedoch derzeit nicht bereitgestellt wird.Verwandte Themen
- Formulare auflisten — die andere Operation an diesem selben Endpunkt.
- Verwaltung von Lead-Listen — die veraltete Lead-Erfassungsfunktion, die Formulare ablösen.
- QR-Codes auflisten / erstellen — finden Sie die
qrid, die Sie beim Erstellen eines Formulars alsqr_idübergeben. - Management-API-Übersicht — das Auth-Schema und die Quota-Architektur, zu der dieser Endpunkt gehört.
Autorisierungen
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. management.scanova.io) — the same key sent to the regular API host will not authenticate.
Antwort
201
Form created
War diese Seite hilfreich?
⌘I