Kreativ.Management stellt dir ein fertiges Kontaktformular bereit, das du ohne technisches Wissen auf deiner Website einbinden kannst. Unter Umständen möchtest du jedoch dein eigenes Formular (oder eines anderen Anbieters) verwenden. Dies ist möglich, wobei es technisch etwas anspruchsvoller wird. Dieser Artikel erklärt dir, wie du dabei vorgehst.

Wichtig: Diese Anbindung funktioniert nur für Kontaktformulare – nicht für Verträge oder Fragebögen.

Falls dein Formular keine direkte API-Anbindung unterstützt, gibt es außerdem die Möglichkeit über das kostenlose Automatisierungstool make.com. Mehr dazu findest du hier.

Übersicht

Voraussetzung: API-fähiges Kontaktformular
Formular in Kreativ.Management anlegen und Standard-Auftragstyp festlegen
Daten weiterleiten
- 3.1 Per JSON
- 3.2 Per x-www-form-urlencoded
- 3.3 Per make.com (ohne Programmierkenntnisse)
Felder zuordnen (Mapping) – inkl. Hinweise zu Datum, Lokation und Auftragstyp
Beispiel: ContactForm7 (WordPress)
Anlage: Postman API Request

1. Voraussetzung: API-fähiges Kontaktformular

Damit die Daten deines Formulars direkt an Kreativ.Management übertragen werden können, muss dein Kontaktformular in der Lage sein, Daten per API weiterzuleiten. Prüfe das vorab in den Einstellungen deines Formularanbieters.

2. Formular in Kreativ.Management anlegen

Gehe zu Einstellungen → Formulare.
Klicke auf Neues Formular.
Wähle als Typ Kontaktformular API Extern aus.

Screenshot: Neues Formular anlegen mit Typ-Auswahl

Speichere das Formular mit Speichern. Auf der rechten Seite erscheint dein API Key (auch „Bearer Auth Key" oder „Formular-ID" genannt) mit dem Hinweis „API-TOKEN. Füge diesen Code in die API ein." Kopiere diesen Key — du trägst ihn im nächsten Schritt in dein externes Formular ein.

Screenshot: API Key in den Formular-Einstellungen

Standard-Auftragstyp festlegen

Im Formular hinterlegst du einen Standard-Auftragstyp. Er wird verwendet, wenn dein externes Formular keinen oder keinen passenden Auftragstyp mitschickt. Schickt dein Formular einen gültigen Auftragstyp mit, hat dieser Vorrang. So stellst du den Standardwert richtig ein:

Öffne unter Einstellungen → Formulare dein Formular vom Typ Kontaktformular API Extern.
Klicke beim Feld Auftragstyp auf das Bearbeiten-Symbol (Stift). Es öffnet sich das Fenster Feld bearbeiten.
Wähle unter Standardwert den gewünschten Auftragstyp aus.
Klicke auf Übernehmen.
Klicke auf Speichern, damit das Formular mit dem neuen Standardwert gespeichert wird.

Achtung: Wenn du den Auftragstyp nur direkt im Auswahlfeld der Formular-Vorschau auswählst, wird das nicht gespeichert. Der Standardwert lässt sich nur über Feld bearbeiten → Standardwert festlegen.

Kommt weder ein gültiger Auftragstyp noch ein Standardwert an, kann die Anfrage nicht angelegt werden.

3. Daten weiterleiten

Gut, die Grundlagen sind geklärt: Du hast ein Formular in Kreativ.Management angelegt und deinen API Key zur Hand. Jetzt richtest du dein externes Formular so ein, dass es die Daten direkt an Kreativ.Management schickt. Die API nimmt Daten als JSON und als Formulardaten (x-www-form-urlencoded) an. Dafür gibt es drei Möglichkeiten:

3.1 Per JSON

Schicke die Daten per HTTP POST an:

https://api.kreativ.management/Form/SubmitExternal

Wichtig: Verwende immer genau diese URL – sie ist dauerhaft verfügbar, auch während wir Updates einspielen. Andere URLs können sich ändern und dazu führen, dass Anfragen nicht ankommen.

Das Format muss so aussehen:

{  "formId": "00000000-0000-0000-0000-000000000000",  "values": {}}

formId: Hier trägst du den API Key ein, den du in Schritt 2 kopiert hast.
values: Hier gibst du die Formularfelder mit den richtigen Schlüsseln an (→ Mapping).

Beispiel mit zwei Feldern:

{  "formId": "00000000-0000-0000-0000-000000000000",  "values": {    "firstname": "Anna",    "email": "anna@beispiel.at"  }}

Hinweis: Welche Einstellungen du in deinem Formularanbieter dafür vornehmen musst, hängt vom jeweiligen Tool ab – dabei können wir leider keinen Support leisten.

3.2 Per x-www-form-urlencoded

Falls dein Formular kein JSON unterstützt, kannst du die Daten auch als x-www-form-urlencoded senden. Die URL ist in diesem Fall eine andere:

https://api.kreativ.management/Form/SubmitExternalFormData

Schicke die Felder als Key-Value-Paare an diese URL. Achtung: Damit diese Methode funktioniert, muss im Header (Kopf) der Übermittlung die Authentifizierung über Bearer Token eingerichtet sein — ohne diesen Key kann das Formular nicht verarbeitet werden.

Trage deinen API Key so im Header ein:

Authorization: Bearer [DEIN API KEY]

Wichtig: Zwischen Bearer und dem Code steht ein Leerzeichen.

Beispiel im Tool „Continually Chatbot":

Header Name: Authorization
Value: Bearer [CODE VON KM]

Screenshot: Bearer Token in Continually Chatbot

3.3 Per make.com (ohne Programmierkenntnisse)

Wenn dein Formular weder JSON noch Bearer-Token unterstützt, kannst du das kostenlose Automatisierungstool make.com als Zwischenschritt nutzen: Dein Formular schickt die Daten an make.com, und make.com leitet sie an Kreativ.Management weiter.

→ Hier findest du das make.com-Tutorial

4. Felder zuordnen (Mapping)

Damit Kreativ.Management weiß, welches Formularfeld wo gespeichert werden soll, musst du die Feldnamen aus deinem Formular den Schlüsseln unten zuordnen.

Kontaktperson

Key	Erlaubte Werte	Feld in Kreativ.Management
`firstname`		Vorname (Hauptkontakt)
`lastname`		Nachname (Hauptkontakt)
`email` (Pflichtfeld)		E-Mail-Adresse
`email2`		E-Mail-Adresse 2
`email3`		E-Mail-Adresse 3
`telephone`		Telefonnummer
`telephone2`		Telefonnummer 2
`telephone3`		Telefonnummer 3
`telephone4`		Telefonnummer 4
`telephone5`		Telefonnummer 5
`website`		Webseite
`website2`		Webseite 2
`website3`		Webseite 3
`companyname`		Firmenname
`gender`	`frau`, `mrs`, `female`, `herr`, `mr`, `male`	Geschlecht
`birthdaydate`		Geburtstag
`weddingdate`		Hochzeitstag
`weddingdate2`		Hochzeitstag 2
`weddingdate3`		Hochzeitstag 3
`common-lastname`		Gemeinsamer Nachname
`street`		Straße
`plz`		PLZ
`city`		Ort
`country`		Land
`typeofperson`		Personenart
`social`		Sozialer Kanal
`social2`		Sozialer Kanal 2
`social3`		Sozialer Kanal 3
`social4`		Sozialer Kanal 4
`social5`		Sozialer Kanal 5
`knownby`		Bekannt von
`tracking`	`ja`, `erlauben`, `aktiv`, `active`, `yes`, `akzeptiert`, `accepted`, `checked`, `1`, `true`	E-Mail-Tracking akzeptiert
`language`		Sprache
`right-of-publication`		Veröffentlichungsrecht
`title-before`		Titel (vor dem Namen)
`title-after`		Titel (nach dem Namen)
`notes`		Notizen
`other-field` bis `other-field10`		Weiteres Feld 1–10
`extra-field` bis `extra-field5`		Extra Feld 1–5

Auftrag

Key	Erlaubte Werte	Feld in Kreativ.Management
`eventtype`	Gültiger Name eines deiner Auftragstypen	Auftragstyp
`startdate`	Format: `dd.MM.yyyy HH:mm` oder `dd.MM.yyyy`	Auftragsdatum (Start)
`enddate`	Format: `dd.MM.yyyy HH:mm` oder `dd.MM.yyyy`	Auftragsdatum (Ende)
`message`		Nachricht
`location`		Lokation

Gut zu wissen: Auftragstyp, Datum und Lokation

eventtype muss genau so geschrieben sein wie der Name deines Auftragstyps (zu finden unter Einstellungen → Mein Profil im Bereich Auftragstypen). Passt der Name nicht, verwendet Kreativ.Management den Standardwert aus deinem Formular (siehe Schritt 2).
startdate und enddate schickst du am besten immer genau im Format dd.MM.yyyy HH:mm (z. B. 05.08.2026 15:30) oder dd.MM.yyyy (z. B. 05.08.2026). Nur diese beiden Formate werden sicher erkannt; andere Schreibweisen, etwa mit Wochentag, nicht zuverlässig. Ein Datum, das nicht erkannt wird, wird ohne Fehlermeldung verworfen – die Anfrage kommt dann ohne Auftragsdatum an.
Schickst du nur ein Startdatum, gilt das Ende am selben Tag (und umgekehrt). Schickst du keine Uhrzeit mit, greift die Standarduhrzeit deines Auftragstyps, falls du eine hinterlegt hast – sonst wird der Auftrag ganztägig angelegt.
location wird nur gespeichert, wenn auch ein gültiges Datum (startdate oder enddate) mitkommt.

Zweit- und Drittkontakt

Key (Zweitkontakt)	Key (Drittkontakt)	Feld
`secondcustomerfirstname`	`thirdcustomerfirstname`	Vorname
`secondcustomerlastname`	`thirdcustomerlastname`	Nachname
`secondcustomeremail`	`thirdcustomeremail`	E-Mail-Adresse
`secondcustomeremail2`	`thirdcustomeremail2`	E-Mail-Adresse 2
`secondcustomeremail3`	`thirdcustomeremail3`	E-Mail-Adresse 3
`secondcustomertelephone`	`thirdcustomertelephone`	Telefonnummer
`secondcustomertelephone2`	`thirdcustomertelephone2`	Telefonnummer 2
`secondcustomertelephone3`	`thirdcustomertelephone3`	Telefonnummer 3
`secondcustomertelephone4`	`thirdcustomertelephone4`	Telefonnummer 4
`secondcustomertelephone5`	`thirdcustomertelephone5`	Telefonnummer 5
`secondcustomerwebsite`	`thirdcustomerwebsite`	Webseite
`secondcustomerwebsite2`	`thirdcustomerwebsite2`	Webseite 2
`secondcustomerwebsite3`	`thirdcustomerwebsite3`	Webseite 3
`secondcustomercompanyname`	`thirdcustomercompanyname`	Firmenname
`secondcustomergender`	`thirdcustomergender`	Geschlecht
`secondcustomerbirthdaydate`	`thirdcustomerbirthdaydate`	Geburtstag
`secondcustomerstreet`	`thirdcustomerstreet`	Straße
`secondcustomerplz`	`thirdcustomerplz`	PLZ
`secondcustomercity`	`thirdcustomercity`	Ort
`secondcustomercountry`	`thirdcustomercountry`	Land
`secondcustomertypeofperson`	`thirdcustomertypeofperson`	Personenart
`secondcustomersocial` bis `secondcustomersocial5`	`thirdcustomersocial` bis `thirdcustomersocial5`	Sozialer Kanal 1–5
`secondcustomerother-field` bis `secondcustomerother-field10`	`thirdcustomerother-field` bis `thirdcustomerother-field10`	Weiteres Feld 1–10
`secondcustomernotes`	`thirdcustomernotes`	Notizen
`secondcustomer-title-before`	`thirdcustomer-title-before`	Titel (vor dem Namen)
`secondcustomer-title-after`	`thirdcustomer-title-after`	Titel (nach dem Namen)

5. Beispiel: ContactForm7 (WordPress)

Viele nutzen WordPress und ContactForm7. Damit ContactForm7 Daten direkt an Kreativ.Management schicken kann, brauchst du ein zusätzliches Plugin:

CF7 to API – Basic Auth (Version 1.4.11)

Lade Version 1.4.11 herunter und installiere diese in WordPress. (Hinweis: Version 1.4.10 funktioniert nicht mehr.)

Sobald das Plugin aktiv ist, siehst du in WordPress bei jedem Kontaktformular einen neuen Reiter:

Screenshot: API Integration Reiter in ContactForm7

Klicke auf den Reiter API Integration und trage folgendes ein:

Aktiviere Send to api.
Bei Base url trägst du https://api.kreativ.management/Form/SubmitExternal ein.
Bei Basic auth key trägst du deinen API Key aus Kreativ.Management ein. Diesen findest du in den Formular-Einstellungen unter Einstellungen → Formulare (siehe Schritt 2).
Bei Input type wählst du Parameters – GET/POST.
Bei Method wählst du POST.
Unter Form fields werden dir alle Felder aufgelistet, die du in deinem Kontaktformular abfragst. Hier musst du nun pro Feld definieren, wo der Inhalt in Kreativ.Management gespeichert werden soll — also welchem Feld es entspricht. Dafür gibst du pro Feld den passenden Key aus dem Mapping an (→ Schritt 4: Mapping). Damit weiß Kreativ.Management zum Beispiel, dass dein Feld „your-firstname" dem Vornamen des Hauptkontakts entspricht.

So sieht das ausgefüllt aus:

Screenshot: ContactForm7 API Integration ausgefüllt

Speichere anschließend das Formular und teste es. Wenn die Anfrage nicht bei Kreativ.Management ankommt, findest du unter + DEBUG LOG (View last transmission attempt) einen Log mit dem genauen Fehlergrund.

Wichtig: Teste immer selbst, ob eine Testanfrage korrekt in deinem Kreativ.Management-Konto landet.

Anlage

Postman Kreativ.Management API Request

Verwandte Artikel

Kontaktformular API Extern Infos