{
"event": "campaign.started",
"data": {
"id": "6f1c2a9e-3b7d-4c55-9a1e-2d8f0b4c7e31",
"application_id": "0b8f6c2e-9d41-4a7b-8e3f-5c1d2a9b6e40",
"name": "White Friday",
"status": "sending",
"goal": "flash",
"pause": null,
"recipients": 4820,
"sent": 0,
"delivered": 0,
"read": 0,
"clicked": 0,
"failed": 0,
"orders": 0,
"revenue": null,
"started_at": "2026-11-03T15:00:00.000Z",
"finished_at": null,
"occurred_at": "2026-11-03T15:00:00.000Z"
},
"sent_at": "1788265862201"
}Campaign started
campaign.started. A campaign began sending (now, or at its scheduled time). Sent to the application’s webhook endpoints that chose it. Verify tawked-signature against the raw body before trusting it, and make handling idempotent on tawked-webhook-id: a delivery can arrive more than once, and deliveries are not guaranteed to arrive in order.
{
"event": "campaign.started",
"data": {
"id": "6f1c2a9e-3b7d-4c55-9a1e-2d8f0b4c7e31",
"application_id": "0b8f6c2e-9d41-4a7b-8e3f-5c1d2a9b6e40",
"name": "White Friday",
"status": "sending",
"goal": "flash",
"pause": null,
"recipients": 4820,
"sent": 0,
"delivered": 0,
"read": 0,
"clicked": 0,
"failed": 0,
"orders": 0,
"revenue": null,
"started_at": "2026-11-03T15:00:00.000Z",
"finished_at": null,
"occurred_at": "2026-11-03T15:00:00.000Z"
},
"sent_at": "1788265862201"
}Authorizations
Authorization: Bearer . An application key (tk_live_, tk_test_) has full access, which covers every product and any product added later, or custom access, chosen when the key is created: one or more of the scopes verify:check, verify:send (includes verify:check), notifications:read, notifications:send (includes notifications:read), email:read, email:send (includes email:read), email:manage (includes email:send), webhooks:manage, email:inbound, notifications:templates (includes notifications:read), chat:menus, chat:attendant. No key made on the API keys page holds notifications:templates, full access included: the three template writes answer such a key 403 insufficient_scope. A connected app's key holds it. Nor chat:menus: the five conversation menu operations answer such a key 403 insufficient_scope, and a connected app's key holds it once the client approved it. Nor chat:attendant: the five auto-attendant operations answer such a key 403 insufficient_scope too, and a connected app's key holds it once the client approved it. email:manage and webhooks:manage are held only by a key someone chose them for: a full-access key, old or new, never holds them. email:inbound, which reads, deletes and forwards received e-mail, is opt-in on every key, full access included: a key holds it only when it was turned on when the key was created. A call outside the key's access answers 403 insufficient_scope and names the scope it needs in the WWW-Authenticate response header. A partner key (tk_partner_) always has full access. Whatever its access, a key is a server-side secret.
Headers
Response
Any 2xx answer within 5 seconds acknowledges the delivery. Anything else, a redirect or no answer in time is retried: 5 attempts in all, the first at once and the next after 1 min, 5 min, 30 min, 2 h.