Events
Create a new event
Create a marketing-automation event on a customer account. An event records an activity (for example a customer interaction, a transaction, or an external trigger) that may launch a marketing-automation scenario configured for the corresponding event type.
What happens when an event is created
- An event record is created and its server-generated event_id is returned.
- If the corresponding event type is wired to a marketing-automation scenario, that scenario is launched and the event's data is passed to it.
- Property records supplied alongside the event are stored as the event's properties; their values are available to the marketing-automation scenario.
Related operations
- GET /event-types - the catalogue of event types configured for the project.
- GET /event-properties - the catalogue of event properties.
- GET /events/{event_id}/property-records - read the property records of an existing event.
post/events
Headers
Accept-Languagestring
The unique ID of the language code by ISO 639-1.
Request body
Example request
{
"event": {
"event_id": "82de12eb8b138791e678fd11c3",
"event_type_id": "8bda8a4854394325e2748a5005",
"customer_id": "8ea2591121e636086a4a9c0992",
"customer_identifier_type": "email",
"customer_identifier_value": "demo@demo.com",
"external_id": "157613",
"created_at": "2021-04-29 14:51:43",
"state": 1
},
"property_records": [
{
"property_record_id": "docasna_blokace_darce_do:8ea2591121e636086a4a9c0992",
"property_id": "docasna_blokace_darce_do",
"property_name": "Property #6",
"last_change": "2023-02-02 00:00:00"
}
]
}Response
Created
Example response
{
"data": {
"event_id": "82de12eb8b138791e678fd11c3"
}
}