WorkOS Docs Homepage
Events
API referenceDashboardSign In
Event typesOverviewOverviewAuthentication eventsAuthentication eventsConnection eventsConnection eventsDirectory Sync eventsDirectory Sync eventsEmail verification eventsEmail verification eventsFeature flag eventsFeature flag eventsInvitation eventsInvitation eventsMagic Auth eventsMagic Auth eventsOrganization eventsOrganization eventsOrganization domain eventsOrganization domain eventsOrganization membership eventsOrganization membership eventsPassword reset eventsPassword reset eventsRole eventsRole eventsSession eventsSession eventsUser eventsUser eventsData syncingOverviewOverviewSyncing with events APISyncing with events APISyncing with webhooksSyncing with webhooksData reconciliationData reconciliationObservabilityStreaming to DatadogStreaming to Datadog
API Reference
API Reference
Integrations
Integrations
Migrate to WorkOS
Migrate to WorkOS
SDKs
SDKs

Organization membership events

Events emitted when users join or leave organizations.

On this page

  • Organization membership created
  • Organization membership deleted
  • Organization membership updated

Events emitted when an AuthKit user joins or leaves an organization.

Organization membership created

Event name: organization_membership.created

Triggered when an organization membership is created.

Payload data corresponds to the Organization Membership object.

Organization membership created event
JSON
{
"event": "organization_membership.created",
"id": "event_04FKJ843CVE8F7BXQSPFH0M53V",
"data": {
"id": "om_01E4ZCR3C56J083X43JQXF3JK5",
"object": "organization_membership",
"user_id": "user_01E4ZCR3C5A4QZ2Z2JQXGKZJ9E",
"organization_id": "org_01E4ZCR3C56J083X43JQXF3JK5",
"status": "pending",
"role": {
"slug": "member"
},
"roles": [
{
"slug": "member"
}
],
"created_at": "2023-11-16T21:32:25.235Z",
"updated_at": "2023-11-16T21:32:25.235Z"
},
"created_at": "2023-11-16T16:32:25.239Z",
"context": {}
}

Organization membership deleted

Event name: organization_membership.deleted

Triggered when an organization membership is deleted.

Payload data corresponds to the Organization Membership object.

Organization membership deleted event
JSON
{
"event": "organization_membership.deleted",
"id": "event_04FKJ843CVE8F7BXQSPFH0M97T",
"data": {
"id": "om_01E4ZCR3C56J083X43JQXF3JK5",
"object": "organization_membership",
"user_id": "user_01E4ZCR3C5A4QZ2Z2JQXGKZJ9E",
"organization_id": "org_01E4ZCR3C56J083X43JQXF3JK5",
"status": "active",
"role": {
"slug": "member"
},
"roles": [
{
"slug": "member"
}
],
"created_at": "2023-11-16T21:32:25.235Z",
"updated_at": "2023-11-27T03:14:45.864Z"
},
"created_at": "2023-11-16T16:32:25.239Z",
"context": {}
}

Organization membership updated

Event name: organization_membership.updated

Triggered when an organization membership is updated.

Payload data corresponds to the Organization Membership object.

Organization membership updated event
JSON
{
"event": "organization_membership.updated",
"id": "event_04FKJ843CVE8F7BXQSPFH0M30K",
"data": {
"id": "om_01E4ZCR3C56J083X43JQXF3JK5",
"object": "organization_membership",
"user_id": "user_01E4ZCR3C5A4QZ2Z2JQXGKZJ9E",
"organization_id": "org_01E4ZCR3C56J083X43JQXF3JK5",
"status": "active",
"role": {
"slug": "member"
},
"roles": [
{
"slug": "member"
}
],
"created_at": "2023-11-16T21:32:25.235Z",
"updated_at": "2023-11-18T17:10:15.121Z"
},
"created_at": "2023-11-16T16:32:25.239Z",
"context": {}
}
© WorkOS, Inc.
FeaturesAuthKitSingle Sign-OnDirectory SyncAdmin PortalFine-Grained Authorization
DevelopersDocumentationChangelogAPI Status
ResourcesBlogPodcastPricingSecuritySupport
CompanyAboutCustomersCareersLegalPrivacy
© WorkOS, Inc.