# Webhook event catalogue

The Events API and signed webhooks carry the same public event envelope. Verify the [raw-body signature](/events/webhook-verification/) before parsing, bind the event to the expected environment and organization where present, and deduplicate by event ID. Delivery attempts can repeat.

| Area               | Public event types                                                                                                                                                                                               |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Organizations      | `organization.created`, `organization.updated`, `organization.deleted`                                                                                                                                           |
| Connections        | `connection.configured`, `connection.activated`, `connection.deactivated`, `connection.deleted`, `connection.test_succeeded`, `connection.test_failed`, `connection.cert_expiring`, `connection.error_rate_high` |
| Domains            | `domain.verified`, `domain.deleted`, `domain.record_missing`                                                                                                                                                     |
| Directory setup    | `dsync.activated`, `dsync.deleted`, `dsync.first_request`                                                                                                                                                        |
| Directory users    | `dsync.user.created`, `dsync.user.updated`, `dsync.user.deleted`                                                                                                                                                 |
| Directory groups   | `dsync.group.created`, `dsync.group.updated`, `dsync.group.deleted`, `dsync.group.user_added`, `dsync.group.user_removed`                                                                                        |
| Sign-ins           | `sso.sign_in.succeeded`, `sso.sign_in.failed`, `sso.logout`                                                                                                                                                      |
| Connection sharing | `connection.shared`, `connection.share_revoked`                                                                                                                                                                  |
| Access signals     | `access.changed`                                                                                                                                                                                                 |
| IdP Radar          | `idp_radar.alert`                                                                                                                                                                                                |
| End users          | `user.created`, `user.updated`, `user.deleted`, `user.invited`, `user.sign_in.challenged`, `user.sign_in.blocked`                                                                                                |
| Memberships        | `membership.created`, `membership.updated`, `membership.deleted`                                                                                                                                                 |
| End-user sessions  | `session.created`, `session.revoked`                                                                                                                                                                             |
| Authorization      | `permission.created`, `permission.updated`, `permission.deleted`, `role.created`, `role.updated`, `role.deleted`, `role_assignment.created`, `role_assignment.deleted`                                           |
| OAuth provider     | `oauth_client.created`, `oauth_client.updated`, `oauth_client.secret_rotated`, `oauth_client.deleted`, `oauth_grant.created`, `oauth_grant.updated`, `oauth_grant.revoked`                                       |
| Feature Flags      | `feature_flag.created`, `feature_flag.updated`, `feature_flag.deleted`                                                                                                                                           |
| Pipes              | `pipe.connection.connected`, `pipe.connection.disconnected`, `pipe.connection.failed`                                                                                                                            |
| Migration          | `import.completed`, `import.organization_switched`, `import.organization_rolled_back`                                                                                                                            |
| Failover           | `edge.failover.activated`, `edge.failover.resolved`                                                                                                                                                              |

The envelope contains `id`, `object`, `type`, `created_at`, `environment`, `api_version` and `data`. `organization`, `directory` and `sequence` appear when applicable. Do not infer an organization when it is absent. Directory sequence handling is described in [ordering](/directory-sync/ordering/); directory-user role and custom values are described in [role mapping](/directory-sync/role-mapping/) and [attributes](/sso/attributes/).

`sso.logout` is described in [SAML single logout](/sso/single-logout/), `access.changed` in [access signals](/signals/) and `idp_radar.alert` in [IdP Radar](/signals/idp-radar/). End-user, authorization and OAuth events are described in [user management](/user-management/), [authorization](/authorization/) and the [OAuth provider](/oauth-provider/).

Failover events contain environment-level `edge_failover` data with `incident_id`, `status` and `occurred_at`; they are not organization events and do not send customer emails. See [standby incident signals](/trust/standby/#incident-signals) and [status](/trust/status/).

Internal compatibility-use and code-exchange/reuse outbox records are not public webhook events. The public catalogue does not expose raw SAML, tokens, credentials or protected attribute-preview source values. Use [Events API catch-up](/events/events-api/) after interrupted delivery and [replay](/events/replay/) when operating recovery.
