MICE Operations bietet einen Webhook an, mit dem Sie Events über die API aus anderen Systemen oder von externen Websites erstellen können.
Achtung! Bevor Sie fortfahren können, benötigen Sie einen API-Key. Diesen können Sie über den Chat in MICE anfordern.
Authentifizierung
Über den Request-Header
Setzen Sie den X-Authorization Request-Header bei jeder Anfrage wie folgt:
Basic 2dd0da7ed23d170efecab01524b67dad409e57a200130a5123817021191a1
Über einen Query-Parameter
Fügen Sie den Parameter key an Ihre URL an:
?key=2dd0da7ed23d170efecab01524b67dad409e57a200130a5123817021191a1
Request-Format
Die API unterstützt ausschließlich das JSON-Format.
Fehler-Response
{
"data": {
},
"page": {
"status": "error",
"status_code": 422,
"message": "Request validation failed",
"errors": {
"locale": "This field is incorrect"
}
}
}
Unterstützte Felder in MICE Operations
Feld | Beschreibung |
datetime_start | Startdatum und -zeit des Events. |
datetime_end | Enddatum und -zeit des Events. |
name | Name des Events (dringend empfohlen). |
group_name | Name der Gruppe. |
guests | Anzahl der Personen (muss eine Zahl sein). |
locale | Sprachpräferenz des Kunden (z.B. |
company | Firmenname des Kunden. |
contact_email | E-Mail-Adresse des Kunden. |
location_id | Die ID eines spezifischen Raums aus dem Setup. |
event_type_id | Die ID eines Veranstaltungstyps (z.B. Meeting, Workshop). |
source | Referenz zur Quelle (z.B. Name des Kontaktformulars). |
Ein Event erstellen
Endpoint: POST /api/v1/webhooks/events
Beispiel
{
"name": "Test event",
"group_name": "MICE Operations",
"locale": "en_US",
"guests": 15,
"contact_first_name": "John",
"contact_last_name": "Doe",
"contact_email": "johndoe@miceoperations.com",
"extra_fields": [
{
"question": "Any remarks?",
"answer": "I would like to have sweet potatoes"
}
]
}Mögliche Antworten
201 – Event wurde erfolgreich erstellt.
401 – Authentifizierung fehlgeschlagen (falscher oder deaktivierter Key).
422 – Datenvalidierung fehlgeschlagen (Pflichtfelder fehlen oder Format falsch).