Webhooks
Overview
Get notified in real-time when events occur in wakit.
wakit can notify your server when messages and conversations change. Configure webhooks per organization through the UI (Settings > Webhooks) or via the REST API.
Configuration
| Field | Type | Description |
|---|---|---|
url | string | The endpoint URL to receive webhook events |
token | string (optional) | Sent as Authorization: Bearer {token} header |
table_name | enum | messages or conversations |
operations | array | ["insert"], ["update"], or ["insert", "update"] |
How it works
- An event occurs (e.g., new incoming message)
- A database trigger fires and checks for matching webhook subscriptions
- For each match, wakit sends a
POSTrequest to your URL with the event data - Up to 3 webhooks per organization per event are supported
Headers
POST /your-webhook-endpoint HTTP/1.1
Content-Type: application/json
Authorization: Bearer {token}The Authorization header is only included if a token is configured.
Delivery
- Webhooks are sent asynchronously via
pg_net - Delivery is best-effort with no automatic retries
- Failed deliveries are not retried — monitor your endpoint for errors
- Webhook events are sent within seconds of the original event