Skip to main content

Event structure

All events delivered through our webhook system follow the CloudEvents specification, an industry standard for describing event data in a consistent and interoperable way.

Each event includes:

Event propertyDescription
idA unique identifier for the event
sourcea value indicating where the event comes from, i.e. https://api.futureordering.com
typeThe event type, e.g. com.futureordering.order.created
specversionThe CloudEvents specification version, e.g. 1.0
timeTimestamp when the event occurred
dataContentTypeThe media type of the event payload, i.e. application/json
dataThe actual event data payload, such as information about what has happened and to whom

Example: JSON event structure as sent to subscribers

{
"specversion": "1.0",
"data": {
"tenantId": "fosts",
...
},
"dataContentType": "application/json",
"id": "7257bc55-cf92-4134-8c50-c80d0839c48b",
"source": "https://api.futureordering.com",
"time": "2025-11-21T09:33:36.1174473+00:00",
"type": "com.futureordering.order.created"
}