Webhooks & Events Overview
Receive real-time notifications about message delivery status, template approvals, and platform events via HTTP callbacks.
What are Webhooks?
Webhooks are HTTP callbacks that Sent sends to your app when events occur. Instead of polling the API for updates, webhooks push events to your endpoint in real-time.
Sent delivers two event types: message for delivery status updates and inbound messages, and templates for template lifecycle updates from Meta. Refer to the Events Reference for the envelope structure, full payloads, and filtering options.
Webhook vs Polling
| Approach | Latency | Efficiency | Complexity |
|---|---|---|---|
| Webhooks | Seconds | High (push) | Medium |
| Polling | Minutes | Low (pull) | Low |
Implementation Paths
Path A: Simple Webhook (5 minutes)
For basic message status tracking:
Configure endpoint - Set up your webhook URL
Verify signatures - Ensure webhook authenticity
Handle events - Process message status updates
Path B: Production Webhook (30 minutes)
For mission-critical applications:
Complete Path A
Implement idempotency - Handle duplicate events
Queue-based processing - Scale with queues
Local development & debugging - Test webhooks locally
Webhook Guides
Webhook Setup
Configure your first webhook endpoint
Lifecycle
How events are delivered, retried, and auto-disabled
Events Reference
Complete reference for all webhook events
Security
Verify webhook authenticity with HMAC
Handling Retries
Idempotency and retry strategies
Local Development & Debugging
Test webhooks on your local machine
Production Checklist
Before going live with webhooks
New to webhooks? Start with Webhook Setup to set up your first webhook endpoint.
Testing with Sandbox Mode
How to test a Sent integration with sandbox mode: assert against real API responses, run CI suites without sending messages, and reproduce failures safely.
Webhook Setup
Register a webhook endpoint in the Sent Dashboard, choose the message and template events to subscribe to, and verify your configuration with a test delivery