Webhooks
Real-time events for every delivery and verification
Push delivery receipts, verification outcomes, and status changes directly into your application — with guaranteed delivery and idempotent processing.
Why Katembe Webhooks
Operational visibility across every product
Signed payloads
Every webhook is HMAC-signed so you can verify authenticity before processing.
Automatic retry
Failed deliveries are retried with exponential backoff — no messages dropped, no manual reconciliation.
Idempotent events
Unique event IDs let you safely deduplicate and replay events without side effects.
Full event catalog
Subscribe to delivery, failure, verification, and system events across all Katembe products.
Delivery Events
Know the exact status of every message sent
Receive granular delivery receipts for SMS, WhatsApp, voice, and email — including carrier-level status codes and timestamps. Update your internal order state, trigger follow-up flows, or alert on failures in real time.
View delivery event schemaOperational Automation
Build reliable workflows on top of event streams
Use webhook events to trigger internal state machines, reconcile failed deliveries, and escalate high-priority failures. Katembe handles retry and deduplication so your handler logic stays simple.
Webhook best practicesQuick setup
Register an endpoint and start receiving events
Point Katembe at any HTTPS endpoint — your existing API, a queue ingestion URL, or a serverless function. Events arrive within seconds of the underlying action.
curl -X POST https://api.katembe.io/v1/webhook-endpoints \
-H "Authorization: Bearer <api_key>" \
-d "url=https://app.example.com/hooks/katembe" \
-d "events[]=message.delivered" \
-d "events[]=verification.completed"
"We use Katembe webhooks to power our real-time order notification system. The signed payloads and automatic retry made the integration surprisingly simple."