It is possible to start workﬂows on demand using an API call. This feature is useful for reﬂecting user interactions with the brand on the website (such as an abandoned shopping cart) or at any other touch point (such as swiping the loyalty card at the cashiers desk) in order to start a corresponding marketing automation scenario within the email platform.
Each custom event is triggered for one subscriber at a time. The custom event API call may include additional data ﬁelds that will be available within workﬂows for the duration of each workﬂow scenario the subscriber participates in.
One custom event may be used to trigger multiple workﬂows at the same time.
In order to use custom events, they need to be deﬁned in Workﬂows > Custom Events ﬁrst. This section allows browsing the existing custom events and deﬁning new events by clicking on the Create new custom event button at the top of the screen:
This will open a pop-up window where you can edit a new event:
Under Name, specify the name of the new custom event. Optionally, add a description of the event.
To log the usage of the custom event, check the Enable event logging checkbox before saving the event. This may be useful if you would like to debug your calls. Please note that at the moment you need to contact your Account Manager to access these logs.
To start using the custom events API ﬁrst memorize its unique ID, which is visible in a column next to the custom event in the Workflow custom events section:
The custom event ID is later referenced in the API call which is fired after the event takes place.