Skip to main content
An Enterprise team can send supported notifications to its own endpoint as signed JSON events. When webhook delivery is enabled, Qwairy does not send the matching email.
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.
A 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.
You can rotate the secret at any time with Regenerate secret (the new value is shown once), and remove the webhook to fall back to email.

Payload

Every request is a POST with a JSON envelope:
The 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.
Verify the signature on every request and reject anything that fails. Use a constant-time comparison, and reject timestamps outside a short window to block replays.

Delivery behavior

  • Qwairy expects a 2xx response. 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.