Webhook event catalog
- Written for
- + Written for
- Deprecated
- + Deprecated
- Applies to
- + Applies to
Atlas delivers signed webhooks (Svix-style) for the events below. Every delivery is signed — verify the signature before trusting it — and carries a stable id you should dedupe on (at-least-once delivery). Payload envelope:
{
"type": "user.created",
"object": "event",
"id": "evt_…",
"timestamp": 1789412514613,
"data": { "object": "user", "id": "user_…", "...": "the resource" }
}Failed deliveries retry on a schedule; you can inspect the delivery log and manually redeliver from the dashboard (per endpoint). Subscribe per-event-type or to everything.
User & auth
Event | Fires when |
| a user is created (sign-up, BAPI, or import) |
| profile / metadata / email changes |
| a user is deleted (PII purge follows on the §GDPR schedule) |
| a user is banned / unbanned |
| a policy directive suspends / lifts (cross-property) |
Sessions
Event | Fires when |
| a session is issued (sign-in complete) |
| a sign-in is mid-flow (e.g. awaiting a second factor) |
| a session is explicitly revoked (per-session or revoke-all) |
| a session ends normally (sign-out / expiry) |
| a session record is removed |
Policy (cross-property host contract)
Event | Fires when |
| a directive is imposed on a user (suspend / read-only / forced-logout) — lands cross-property in seconds |
Organizations & B2B
Event | Fires when |
| org lifecycle |
| membership + role changes |
| invitation lifecycle |
| verified email-domain (auto-join) lifecycle |
Roles & permissions (RBAC)
Event | Fires when |
| custom role changes |
| permission changes |
Enterprise (SSO / SCIM)
Event | Fires when |
| per-org SAML/OIDC connection changes |
| a per-org SCIM bearer is minted / revoked |
Messaging & billing & waitlist
Event | Fires when |
| an outbound email / SMS is dispatched |
| billing subscription lifecycle (from the signature-verified Stripe webhook) |
| waitlist signups |
Verifying a delivery
Read the signature header and verify with your endpoint's signing secret (Svix scheme).
Dedupe on
event.id.Switch on
type;data.objectnames the resource shape.
Reject anything that fails signature verification — never trust an unsigned body.