Skip to navigation
API ReferenceWebhooks

Event: sent

View as Markdown

Triggered when the provider has accepted the message and handed it off toward the recipient. WhatsApp only - the SMS channel does not emit sent, and the email channel emits no webhooks at all.

Headers Teekrr sends

HeaderValue
Content-Typeapplication/json
X-Teekrr-Signaturet=<unix seconds>,v1=<HMAC-SHA256 hex> - see the Webhooks guide
X-Teekrr-Eventsent
X-Teekrr-Channelwhatsapp

Payload

The payload of this webhook request is an object.
eventenumRequired
Allowed values:
channelenumRequired
Allowed values:
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

Payload shape for sent / delivered / read / failed. Identical on every channel - one handler parses both SMS and WhatsApp. SMS emits only delivered and failed; sent and read are WhatsApp-only.

Response

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