[POST] /api/v2/embedded-messages/report-events
This endpoint is used to report one or more user engagement events, such as when a message is read, clicked, or deleted.
Query Parameters
tenantId
(integer, required): Your tenant ID.brandId
(string, required): The ID of the specific brand you are targeting.
Request Body
The request body should be a JSON array of one or more event objects. Each object has the following properties:
timestamp
(string, required): The UTC timestamp for when the event occurred, in ISO 8601 format.uuid
(string, required): A unique identifier for this event.eventType
(string, required): The type of event being reported. See the list of available event types below.customerId
(string, conditional): The ID for a known customer. One ofcustomerId
orvisitorId
must be provided.visitorId
(string, conditional): The ID for an anonymous visitor. One ofcustomerId
orvisitorId
must be provided.context
(object, required): An object containing additional data specific to the event type. See the context object structure below.
Event Types
The following values are currently supported for the eventType
field:
embedded-message.read
embedded-message.unread
embedded-message.clicked
embedded-message.deleted
Context Object
For all current event types, the context
object requires the following properties:
messageId
(string): The unique ID of the message the event relates to.containerId
(string): The ID of the container the message belongs to.
Example Request Body
This example shows how to report a single read
event.
[
{
"timestamp": "2025-07-03T07:35:01.869Z",
"uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"eventType": "embedded-message.read",
"customerId": "opt__001",
"context": {
"messageId": "60808861-5cb7-4f76-b8f9-dc80b5b842ef",
"containerId": "Inbox"
}
}
]
Responses
204 No Content
- Success
204 No Content
- SuccessIf the event data is valid and successfully processed, the API will return a 204 No Content
status with an empty body.