Skip to content

docs: document organization.membership.updated delta payload #1413

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
simeng-li wants to merge 6 commits into
base: master
Choose a base branch
from
Open

docs: document organization.membership.updated delta payload #1413

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
6b19771
docs: document organization.membership.updated delta payload
simeng-li May 21, 2026
2d8c9ed
chore: sync translations for webhooks request and events docs
simeng-li May 21, 2026
6848f4c
docs: fix webhook cross-link slugs to id-based paths
simeng-li May 21, 2026
80757cd
docs: address copilot review on webhook payload docs
simeng-li May 22, 2026
c4e0d83
docs: trim jit-emission note and remove em dashes in webhook payload …
simeng-li May 22, 2026
7fa121b
docs: drop jit no-op note and use positive framing in trigger row
simeng-li May 22, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 18 additions & 13 deletions docs/developers/webhooks/events.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -47,12 +47,12 @@ This guide list the different Logto webhook events and explains when each event

### Organization \{#organization}

| Event type | Description |
| ------------------------------- | ------------------------------------------------------------------------------------------ |
| Organization.Created | A new organization is created. |
| Organization.Deleted | An organization is deleted. |
| Organization.Data.Updated | An organization's data is updated, e.g., organization name, description, custom.data, etc. |
| Organization.Membership.Updated | Members are added or removed from an organization. |
| Event type | Description |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Organization.Created | A new organization is created. |
| Organization.Deleted | An organization is deleted. |
| Organization.Data.Updated | An organization's data is updated, e.g., organization name, description, custom.data, etc. |
| Organization.Membership.Updated | Users or applications are added to or removed from an organization. Payload includes [membership delta fields](/developers/webhooks/webhooks-request#organizationmembershipupdated-payload). |

### Organization role \{#organization-role}

Expand Down Expand Up @@ -96,6 +96,10 @@ This guide list the different Logto webhook events and explains when each event
| PUT /organizations/:id/users | Organization.Membership.Updated |
| POST /organizations/:id/users | Organization.Membership.Updated |
| DELETE /organizations/:id/users/:userId | Organization.Membership.Updated |
| PUT /organizations/:id/applications | Organization.Membership.Updated |
| POST /organizations/:id/applications | Organization.Membership.Updated |
| DELETE /organizations/:id/applications/:applicationId | Organization.Membership.Updated |
| PUT /organization-invitations/:id/status (Accepted) | Organization.Membership.Updated |
| POST /organization-roles | OrganizationRole.Created, (OrganizationRole.Scopes.Updated) |
| DELETE /organization-roles/:id | OrganizationRole.Deleted |
| PATCH /organization-roles/:id | OrganizationRole.Data.Updated |
Expand All @@ -108,13 +112,14 @@ This guide list the different Logto webhook events and explains when each event

### Experience API triggered events \{#experience-api-triggered-events}

| User interaction action | Event |
| ------------------------ | ----------------- |
| User email/phone linking | User.Data.Updated |
| User MFAs linking | User.Data.Updated |
| User social/SSO linking | User.Data.Updated |
| User password reset | User.Data.Updated |
| User registration | User.Created |
| User interaction action | Event |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------- |
| User email/phone linking | User.Data.Updated |
| User MFAs linking | User.Data.Updated |
| User social/SSO linking | User.Data.Updated |
| User password reset | User.Data.Updated |
| User registration | User.Created |
| User auto-provisioned into an organization via [just-in-time provisioning](/organizations/just-in-time-provisioning) (matching email domain or enterprise SSO connector) | Organization.Membership.Updated |

## Exception hook events \{#exception-hook-events}

Expand Down
Loading
Loading