Webhooks
Subscribe to Taifa Mail events and receive signed JSON at your own HTTPS endpoint to drive your app and automations.
Webhooks push events from Taifa Mail to an endpoint you control. Each delivery is signed so you can trust the payload before acting on it.
Use cases
- Update your database the moment a message is delivered.
- Pipe inbound-forwarded mail into your own app or CRM.
- Drive workflows in n8n, Zapier or Make from email events.
Step 1: Add an endpoint
- In the dashboard, go to Settings -> Webhooks.
- Add a public HTTPS URL. Plain HTTP and private addresses are rejected.
- Copy the signing secret.
Step 2: Verify the signature
Each request carries an HMAC-SHA256 signature computed with your secret. Recompute it over the raw body and compare before trusting the event.
Step 3: Send a test
Use the test button to fire a sample event and confirm your endpoint responds with a 2xx status. Failed deliveries are retried on a schedule (1m, 5m, 30m, 2h, 8h).
Today, the delivered test event and the inbound forwarded event fire to webhooks. Dedicated open, click and bounce events are on the roadmap. Until then, opens and clicks are visible in Tracking and over the API.