Skip to content

Event catalog

Every event’s body has the same envelope (see the request); data is a Backend API object, as it was when the event happened. Payload opens the event’s full body in the API reference.

user.created

A user was created: a completed sign-up, or a user created in the dashboard or with the Backend API. A request that creates a user and changes it sends this one event.

data: User. Payload · The same object in the Backend API

user.updated

A user changed: profile, email addresses, password, two-step verification, passkeys, connected accounts, metadata, a ban or an unban. A request that changes a user in several ways sends one event with the user as it is afterwards.

data: User. Payload · The same object in the Backend API

user.deleted

A user was deleted: by themselves, in the dashboard or with the Backend API.

data: Deleted object (id only). Payload

session.created

A session became active: after a sign-in or sign-up, or once a pending session finished its tasks (a pending session sends no event).

data: Session. Payload · The same object in the Backend API

session.ended

A session ended without being revoked: the user signed out, it was replaced by a new sign-in on the same browser, or it expired or timed out. data.status and data.end_reason say which.

data: Session. Payload · The same object in the Backend API

session.revoked

A session was revoked: in the dashboard or with the Backend API, by the user from another device, or because the user was banned or deleted, or their password or two-step verification changed. data.end_reason says why.

data: Session. Payload · The same object in the Backend API

organization.created

An organization was created: by a user, in the dashboard or with the Backend API.

data: Organization. Payload · The same object in the Backend API

organization.updated

An organization changed: its name, slug, member limit, deletion setting or metadata. One event per request, with the organization as it is afterwards.

data: Organization. Payload · The same object in the Backend API

organization.deleted

An organization was deleted.

data: Deleted object (id only). Payload

organizationMembership.created

A user became a member of an organization: added by an administrator or the Backend API, by accepting an invitation, or as the creator of a new organization.

data: Organization membership. Payload · The same object in the Backend API

organizationMembership.updated

A membership changed: its role or its metadata.

data: Organization membership. Payload · The same object in the Backend API

organizationMembership.deleted

A member left or was removed. data is the membership as it was, so you know which organization and user it joined.

data: Organization membership. Payload · The same object in the Backend API

An invitation in an event has no url: the invitation link is only in the response that created it.

organizationInvitation.created

An invitation to an organization was created.

data: Organization invitation. Payload · The same object in the Backend API

organizationInvitation.accepted

An invitation was accepted; data.accepted_user_id is the user who accepted it.

data: Organization invitation. Payload · The same object in the Backend API

organizationInvitation.revoked

An invitation was revoked.

data: Organization invitation. Payload · The same object in the Backend API