Event: delivered | Teekrr | API Documentation

Triggered when the provider confirms successful delivery to the recipient’s device. Emitted for SMS and WhatsApp; the email channel emits no webhooks.

The data shape differs per channel - read channel (or the X-Teekrr-Channel header) before parsing data.

Headers Teekrr sends

Header	Value
`Content-Type`	`application/json`
`X-Teekrr-Signature`	`t=<unix seconds>,v1=<HMAC-SHA256 hex>`
`X-Teekrr-Event`	`delivered`
`X-Teekrr-Channel`	`sms` \| `whatsapp`

Triggered when the provider confirms successful delivery to the recipient's device. Emitted for **SMS** and **WhatsApp**; the email channel emits no webhooks. The `data` shape differs per channel - read `channel` (or the `X-Teekrr-Channel` header) before parsing `data`. ## Headers Teekrr sends | Header | Value | | --- | --- | | `Content-Type` | `application/json` | | `X-Teekrr-Signature` | `t=<unix seconds>,v1=<HMAC-SHA256 hex>` | | `X-Teekrr-Event` | `delivered` | | `X-Teekrr-Channel` | `sms` \| `whatsapp` |

Payload

The payload of this webhook request is an object.

eventenumRequired

channelenumRequired

api_keyobjectRequired

The API key whose broadcast produced this event, so a consumer whose several keys point at one endpoint can tell them apart. null for a dashboard-composed send or an unattributable message.

timestampdatetimeRequired

When Teekrr built the payload (ISO 8601, UTC).

dataobjectRequired

Response

2XX

Acknowledge receipt within 10 seconds. Any 2xx counts as success.

1	{
2	"event": "delivered",
3	"channel": "sms",
4	"api_key": {
5	"uuid": "00000000-0000-0000-0000-0000000000ak",
6	"name": "Production integration"
7	},
8	"timestamp": "2026-05-06T10:15:00.123Z",
9	"data": {
10	"message_id": "MSG-ABC123XYZ",
11	"provider_status": "DELIVRD",
12	"msisdn": "60123456789"
13	}
14	}