Outbound webhooks are part of Agencies, an Enterprise capability. The controls are OWNER-only.
Events
report.weekly
A workspace’s weekly report.
export.ready
A data export has finished and is ready to download.
webhook.test event is also sent by the Send test event button so you can validate your endpoint before turning delivery on.
Configure delivery
1
Open Notifications
Go to Team Management > Notifications and find Outbound webhooks.
2
Add your endpoint URL
Enter a public
https URL and save it. Private addresses and http URLs are rejected. A signing secret is generated and shown once; copy and store it.3
Send a test event
Click Send test event to confirm Qwairy can reach your endpoint and your signature check passes.
4
Enable delivery
Toggle Deliver via webhook on. From now on, the events above go to your endpoint instead of being emailed.
Payload
Every request is aPOST with a JSON envelope:
data object is event-specific. Treat it as forward-compatible: new fields may be added, so ignore the ones you don’t use rather than rejecting the payload.
Headers
Verify the signature
The signature is an HMAC-SHA256 keyed with your signing secret. Its input is<timestamp>.<body> using the raw request bytes before JSON parsing.
Delivery behavior
- Qwairy expects a
2xxresponse. Non-2xx, timeouts, and redirects count as failures. - A failed weekly-report delivery is retried on the next scheduled run; the matching email is not sent in its place.
- The export-ready event is one-shot: if delivery fails, the export still appears in your workspace’s Exports hub.

