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 einfachem JSON (ohne formId)
3.4 Per make.com (ohne Programmierkenntnisse)
Felder zuordnen (Mapping) – inkl. Hinweise zu Datum, Lokation und Auftragstyp
Beispiel: ContactForm7 (WordPress)
Wenn die Anfrage nicht ankommt
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.
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.
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. Wichtig ist, dass dein API Key mitkommt – sonst weiß Kreativ.Management nicht, zu welchem Formular die Anfrage gehört, und lehnt sie ab. Welche Adresse du verwendest, hängt davon ab, in welchem Format dein Formular sendet:
JSON mit formId und values →
Form/SubmitExternal(3.1)Formulardaten (Key-Value-Paare, x-www-form-urlencoded, in vielen Tools „Parameters“ genannt) →
Form/SubmitExternalFormData(3.2)Einfaches JSON nur mit den Feldern, ohne formId →
Form/SubmitExternalJson(3.3)Kein API-Versand möglich → make.com (3.4)
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).
Achtung: Diese Adresse liest den API Key nur aus formId im Inhalt. Eine Anmeldung im Header (zum Beispiel „Basic auth“ oder „Bearer“) wertet sie nicht aus. Schickt dein Tool Formulardaten statt JSON, nimm 3.2.
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: Ohne deinen API Key kann das Formular nicht verarbeitet werden. Du übergibst ihn auf eine dieser zwei Arten:
a) In der Adresse – praktisch, wenn dein Tool keine eigenen Header erlaubt:
https://api.kreativ.management/Form/SubmitExternalFormData?formId=[DEIN API KEY]
b) Im Header (Kopf) der Übermittlung als Bearer Token:
Authorization: Bearer [DEIN API KEY]
Wichtig: Zwischen Bearer und dem Code steht ein Leerzeichen.
Beispiel im Tool „Continually Chatbot":
Header Name:
AuthorizationValue:
Bearer [CODE VON KM]
3.3 Per einfachem JSON (ohne formId)
Schickt dein Tool ein JSON nur mit den Feldern, verwendest du diese URL:
https://api.kreativ.management/Form/SubmitExternalJson
Beispiel:
{ "firstname": "Anna", "email": "anna@beispiel.at"}Den API Key übergibst du wie bei 3.2 in der Adresse (?formId=[DEIN API KEY]) oder im Header (Authorization: Bearer [DEIN API KEY]). Alle Werte müssen einfache Texte sein – verschachtelte Objekte oder Listen lehnt Kreativ.Management ab.
3.4 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.
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 |
| Vorname (Hauptkontakt) | |
| Nachname (Hauptkontakt) | |
| E-Mail-Adresse | |
| E-Mail-Adresse 2 | |
| E-Mail-Adresse 3 | |
| Telefonnummer | |
| Telefonnummer 2 | |
| Telefonnummer 3 | |
| Telefonnummer 4 | |
| Telefonnummer 5 | |
| Webseite | |
| Webseite 2 | |
| Webseite 3 | |
| Firmenname | |
|
| Geschlecht |
| Geburtstag | |
| Hochzeitstag | |
| Hochzeitstag 2 | |
| Hochzeitstag 3 | |
| Gemeinsamer Nachname | |
| Straße | |
| PLZ | |
| Ort | |
| Land | |
| Personenart | |
| Sozialer Kanal | |
| Sozialer Kanal 2 | |
| Sozialer Kanal 3 | |
| Sozialer Kanal 4 | |
| Sozialer Kanal 5 | |
| Bekannt von | |
|
| E-Mail-Tracking akzeptiert |
| Sprache | |
| Veröffentlichungsrecht | |
| Titel (vor dem Namen) | |
| Titel (nach dem Namen) | |
| Notizen | |
| Weiteres Feld 1–10 | |
| Extra Feld 1–5 |
Auftrag
Key | Erlaubte Werte | Feld in Kreativ.Management |
| Gültiger Name eines deiner Auftragstypen | Auftragstyp |
| Format: | Auftragsdatum (Start) |
| Format: | Auftragsdatum (Ende) |
| Anfragetext am Auftrag (die Nachricht deines Kunden) | |
| Lokation |
message oder notes? Die Nachricht deines Kunden aus dem Formular gehört in message – dann siehst du sie direkt in der Anfrage am Auftrag. notes landet in den Notizen des Kontakts.
Pflichtangaben
email– ohne E-Mail-Adresse wird keine Anfrage angelegt.Auftragstyp – entweder per
eventtypemitschicken oder als Standardwert im Formular hinterlegen (siehe Schritt 2).
Gut zu wissen: Auftragstyp, Datum und Lokation
eventtypemuss 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).startdateundenddateschickst du am besten immer genau im Formatdd.MM.yyyy HH:mm(z. B. 05.08.2026 15:30) oderdd.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.
locationwird nur gespeichert, wenn auch ein gültiges Datum (startdateoderenddate) mitkommt.
Zweit- und Drittkontakt
Key (Zweitkontakt) | Key (Drittkontakt) | Feld |
|
| Vorname |
|
| Nachname |
|
| E-Mail-Adresse |
|
| E-Mail-Adresse 2 |
|
| E-Mail-Adresse 3 |
|
| Telefonnummer |
|
| Telefonnummer 2 |
|
| Telefonnummer 3 |
|
| Telefonnummer 4 |
|
| Telefonnummer 5 |
|
| Webseite |
|
| Webseite 2 |
|
| Webseite 3 |
|
| Firmenname |
|
| Geschlecht |
|
| Geburtstag |
|
| Straße |
|
| PLZ |
|
| Ort |
|
| Land |
|
| Personenart |
|
| Sozialer Kanal 1–5 |
|
| Weiteres Feld 1–10 |
|
| Notizen |
|
| Titel (vor dem Namen) |
|
| 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:
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:
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/SubmitExternalFormData?formId=[DEIN API KEY]ein – also die Adresse für Formulardaten mit deinem API Key am Ende. Deinen API Key findest du unter Einstellungen → Formulare (siehe Schritt 2).Das Feld Basic auth key brauchst du nicht – Kreativ.Management wertet es nicht aus. Entscheidend ist der API Key in der Base url.
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. Dein Nachrichtenfeld ordnest du dem Key
messagezu.
So sieht das ausgefüllt aus:
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.
6. Wenn die Anfrage nicht ankommt
Fehler beim Absenden (z. B. HTTP 500): Meistens fehlt der API Key oder er kommt an der falschen Stelle an. Prüfe, ob Adresse und Format zusammenpassen:
SubmitExternalnur mit JSON samtformId,SubmitExternalFormDatafür Formulardaten undSubmitExternalJsonfür einfaches JSON – bei beiden mit dem Key in der Adresse oder im Header. Weitere Gründe für diesen Fehler: Das Formular ist in Kreativ.Management nicht verfügbar, es kamen in den letzten 24 Stunden zu viele Anfragen über dieses Formular, oder das JSON ist ungültig.Absenden klappt, aber keine Anfrage in Kreativ.Management: Kreativ.Management nimmt die Anfrage zuerst an und verarbeitet sie danach. Fehlen dabei
emailoder ein Auftragstyp, wird keine Anfrage angelegt – dein Formular meldet trotzdem Erfolg. Prüfe die Pflichtangaben in Schritt 4.In ContactForm7 findest du unter + DEBUG LOG (View last transmission attempt) die letzte Übertragung mit dem genauen Fehlergrund.
Kommt die Anfrage trotz richtiger Einrichtung nicht an, schreib uns im Chat und schick uns den Debug-Log mit.





