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
Daten weiterleiten
- 3.1 Per JSON
- 3.2 Per x-www-form-urlencoded
- 3.3 Per make.com (ohne Programmierkenntnisse)
Felder zuordnen (Mapping)
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. Auf der rechten Seite erscheint dein API Key (auch „Bearer Auth Key" oder „Formular-ID" genannt). Kopiere diesen Key — du trägst ihn im nächsten Schritt in dein externes Formular ein.

Screenshot: API Key in den Formular-Einstellungen

Tipp: Du kannst im Formular einen Standard-Auftragstyp hinterlegen. Schickt dein externes Formular keinen Auftragstyp mit, wird automatisch dieser verwendet. Wenn doch ein Auftragstyp mitgesendet wird, hat der mitgesendete Vorrang.

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. 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`	Auftragsdatum (Start)
`enddate`	Format: `dd.MM.yyyy HH:mm`	Auftragsdatum (Ende)
`message`		Nachricht
`location`		Lokation

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.