Skip to content
Dashboard
Theme
Theme

Webhook event catalogue

Public event types and the tenant-scoped event envelope.

View Markdown

The Events API and signed webhooks carry the same public event envelope. Verify the raw-body signature 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-user role and custom values are described in role mapping and attributes.

sso.logout is described in SAML single logout, access.changed in access signals and idp_radar.alert in IdP Radar. End-user, authorization and OAuth events are described in user management, authorization and the 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 and 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 after interrupted delivery and replay when operating recovery.