Docs · Core concepts

Webhooks

Get events pushed to your server as they happen: deliveries, failures, replies and payments.

Add your endpoint
Set an HTTPS URL and choose your events with PUT /v1/developer/webhooks, or in the dashboard.
Send a test
POST /v1/developer/webhooks/test sends a sample event so you can check your handler.
Answer fast
Return any 2xx status within 10 seconds, then do slow work in the background.

Retries and logs

If your endpoint fails or times out, talks retries with backoff. Every attempt is in GET /v1/developer/webhooks/logs, and you can resend any event with POST /v1/developer/webhooks/events/{eventId}/retry.

Warning: Events can arrive more than once or out of order. Use the event id to ignore duplicates.

Example event

{
  "id": "evt_5Fq2mZx1",
  "type": "sms.delivered",
  "created_at": "2026-11-13T19:24:06Z",
  "data": {
    "id": "sms_8f2k1x",
    "to": "+254712345678",
    "status": "delivered"
  }
}

Use a tk_test_ key while you build. Nothing is sent and no credits are used.

Was this page helpful?

Webhooks

Add your endpoint

Send a test

Answer fast

Retries and logs