---
sidebar_label: 'Event structure'
sidebar_position: 3
---

# Event structure

All events delivered through our webhook system follow [the CloudEvents specification](https://cloudevents.io), an industry standard for describing event data in a consistent and interoperable way. 

Each event includes:

| Event property | Description |
| --- | --- |
| `id` | A unique identifier for the event |
| `source` | a value indicating where the event comes from, i.e. `https://api.futureordering.com` |
| `type` | The event type, e.g. `com.futureordering.order.created` |
| `specversion` | The CloudEvents specification version, e.g. 1.0 |
| `time` | Timestamp when the event occurred |
| `dataContentType` | The media type of the event payload, i.e. `application/json` |
| `data` | The actual event data payload, such as information about what has happened and to whom |

## Example: JSON event structure as sent to subscribers

```json
{
    "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"
}
```