- Sender Webhooks: Receive events for a specific sender (messages, conversations)
- Project Webhooks: Receive project-level events (partner invitations)
Project Webhooks
Project webhooks are ideal for receiving notifications about project-level events, such as when a partner invitation is completed. This is particularly useful if you’re using the Partner Invitations API to onboard clients.Via Dashboard
- Go to Dashboard and select your project
- Navigate to Webhooks in the sidebar
- In the “Project Webhook” section, click Configure
- Enter your webhook URL and select the events you want to receive
- Save - you’ll receive a signing secret
Via API
Configure a project webhook using the invitations API:cURL
Managing Project Webhooks
Get current configuration:cURL
cURL
cURL
Project Webhook Events
Project Webhook Payload
Project webhooks are independent of sender webhooks. You can have both configured simultaneously.
Sender Webhooks
Each sender can have one webhook configured. Webhooks are managed as part of the sender resource.Via Dashboard
- Go to Dashboard and select your project
- Navigate to your Sender’s settings
- Click Add Webhook
- Enter your webhook URL and select the events you want to receive
- Save - you’ll receive a signing secret
Via API
Configure a webhook when creating a new sender:cURL
Available Events
Inbound (Receiving Messages)
Outbound (Delivery Tracking)
Templates
Partner Invitations (Project Webhook)
The
invitation.status_changed event is delivered via Project Webhooks, not Sender Webhooks. See the Project Webhooks section above for configuration.Webhook Payload
All webhook payloads follow the same structure:Handling Webhooks
Your webhook endpoint must:- Respond with 2xx status within 30 seconds
- Verify the signature to ensure the request is from Zavu
- Process asynchronously for long-running tasks
Retry Policy
If your endpoint returns an error or doesn’t respond within 30 seconds, Zavu will retry the delivery:
After 5 failed attempts, the webhook delivery is marked as failed. You can view failed deliveries in the Dashboard.
Managing Webhooks
Update Webhook Configuration
Update your sender’s webhook settings:cURL
Disable Webhook
cURL
Remove Webhook
SetwebhookUrl to null to remove the webhook:
cURL
Regenerate Secret
If your webhook secret is compromised:cURL
Next Steps
- Event Types - Detailed payload for each event
- Security - Verify webhook signatures
