Imports a batch of events associated to contacts.
This feature is in preview
This feature is in public preview and therefore is available to be used however it may be subject to change.
You must have a CXDP account to access this API
Collate and upload events to Dotdigital from your platforms which can be shown on a contact's Single customer view. The data is also available as an Insight data collection for use in segmentation and personalization.
Events
Each event must be associated with an existing contact within Dotdigital using any contact identifier type you want, including Custom identifiers.
Each event has:
| Field | Description |
|---|---|
| type | The notional type of the event which is displayed on the contact's timeline on the Single customer view. |
| id | A unique ID for the event, for example, a GUID. |
| eventTimestamp | The UTC date and time the event occurred in ISO 8601 format. |
| timelineDetails.summary | If specified, this is the description of the event to be shown in the contact's timeline on the Single customer view. |
| eventData | The actual data for the event as a JSON object. |
BatchingFor efficiency, we strongly recommend batching and importing your events in bulk. You can import up to 50MB of data per request. These events are then asynchronously imported in the background.