Webhook events · broadcasts
broadcast.created/1
Broadcast created. A broadcast was created in the app.
Payload
We POST this JSON to your endpoint. Answer any 2xx within 30 seconds. The same id arrives again on a retry — skip ones you have handled.
| Field | Type | What it is |
|---|---|---|
| idrequired | string | Event id. The same on every retry: use it to skip duplicates.pattern ^evt_[0-9A-HJKMNP-TV-Z]{26}$ |
| typerequired | string | Event type.always broadcast.created |
| versionrequired | string | Payload version.always 1 |
| api_versionrequired | string | The endpoint's API version. |
| occurred_atrequired | string | When it happened.date-time |
| company_idrequired | integer | Your workspace id. |
| datarequired | object | |
| idrequired | integer | Broadcast id. |
| company_idrequired | integer | Workspace id. |
| channel_idrequired | integer | Channel id. |
| name | string or null | Name. |
| statusrequired | string | Status. |
| scheduled_at | string or null | ISO 8601. |
| totalsrequired | object | |
| failedrequired | integer | Failed. |
| recipientsrequired | integer | Recipients. |
| sentrequired | integer | Sent. |
Example
{
"id": "evt_01J8Z7BZQ4F6G8J2K5N7Q9S1VC",
"type": "broadcast.created",
"version": "1",
"api_version": "2026-10-01",
"occurred_at": "2026-09-24T09:20:00Z",
"company_id": 1001,
"data": {
"id": 8812,
"company_id": 1001,
"channel_id": 301,
"name": "September sale",
"status": "SCHEDULED",
"scheduled_at": "2026-09-15T07:00:00Z",
"totals": {
"failed": 0,
"recipients": 5300,
"sent": 0
}
}
}Headers
Webhook-Signature:t=…,v1=…— how to check itWebhook-Id(alsoWebhook-Event-Id): the event id, the same on every retry — skip ones you have handledWebhook-Delivery-Id: this delivery attempt, new on every try