Zum Hauptinhalt springen

Kontaktformular API Extern Infos

verwende eigene Kontaktformulare und sende direkt die Daten an Kreativ.Management

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

  1. Voraussetzung: API-fähiges Kontaktformular

  2. Formular in Kreativ.Management anlegen und Standard-Auftragstyp festlegen

  3. 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)

  4. Felder zuordnen (Mapping) – inkl. Hinweise zu Datum, Lokation und Auftragstyp

  5. Beispiel: ContactForm7 (WordPress)

  6. Wenn die Anfrage nicht ankommt

  7. 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

  1. Gehe zu Einstellungen → Formulare.

  2. Klicke auf Neues Formular.

  3. Wähle als Typ Kontaktformular API Extern aus.

Screenshot: Neues Formular anlegen mit Typ-Auswahl
  1. 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:

  1. Öffne unter Einstellungen → Formulare dein Formular vom Typ Kontaktformular API Extern.

  2. Klicke beim Feld Auftragstyp auf das Bearbeiten-Symbol (Stift). Es öffnet sich das Fenster Feld bearbeiten.

  3. Wähle unter Standardwert den gewünschten Auftragstyp aus.

  4. Klicke auf Übernehmen.

  5. 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: Authorization

  • Value: Bearer [CODE VON KM]

Screenshot: Bearer Token in Continually Chatbot

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

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

Anfragetext am Auftrag (die Nachricht deines Kunden)

location

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 eventtype mitschicken oder als Standardwert im Formular hinterlegen (siehe Schritt 2).

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:

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:

  1. Aktiviere Send to api.

  2. 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).

  3. Das Feld Basic auth key brauchst du nicht – Kreativ.Management wertet es nicht aus. Entscheidend ist der API Key in der Base url.

  4. Bei Input type wählst du Parameters – GET/POST.

  5. Bei Method wählst du POST.

  6. 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 message zu.

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.


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: SubmitExternal nur mit JSON samt formId, SubmitExternalFormData für Formulardaten und SubmitExternalJson fü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 email oder 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.


Anlage

Hat dies deine Frage beantwortet?