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 events

Events emitted when WorkOS organizations are changed.

On this page

  • Organization created
  • Organization updated
  • Organization deleted

Events emitted when WorkOS organizations are created, updated, or deleted.

Organization created

Event name: organization.created

Triggered when an organization is created.

Payload data corresponds to the Organization object.

Organization created
JSON
{
"event": "organization.created",
"id": "event_04FKJ843CVE8F7BXQSPFH0M30K",
"data": {
"id": "org_01HV1VNQBQ24JVREYB94RFCNDC",
"name": "Foo Corp",
"object": "organization",
"external_id": null,
"domains": [
{
"id": "org_domain_01HV1VX5N18E48ETTHNNK54R6S",
"state": "verified",
"domain": "foo-corp.com",
"object": "organization_domain",
"organization_id": "org_01HV1VNQBQ24JVREYB94RFCNDC",
"verification_strategy": "manual",
"verification_prefix": "superapp-domain-verification-z3kjny",
"verification_token": "gBIJgYXZLjW8uHHpz614dkgqm",
"created_at": "2023-11-27T19:07:33.155Z",
"updated_at": "2023-11-27T19:07:33.155Z"
}
],
"created_at": "2023-11-16T16:32:25.239Z",
"updated_at": "2023-11-16T16:32:25.239Z"
},
"created_at": "2023-11-16T16:32:25.239Z",
"context": {}
}

Organization updated

Event name: organization.updated

Triggered when an organization is updated.

Payload data corresponds to the Organization object.

Organization updated
JSON
{
"event": "organization.updated",
"id": "event_04FKJ843CVE8F7BXQSPFH0M30K",
"data": {
"id": "org_01HV1VNQBQ24JVREYB94RFCNDC",
"name": "Foo Corp",
"object": "organization",
"external_id": null,
"domains": [
{
"id": "org_domain_01HV1VX5N18E48ETTHNNK54R6S",
"state": "verified",
"domain": "foo-corp.com",
"object": "organization_domain",
"organization_id": "org_01HV1VNQBQ24JVREYB94RFCNDC",
"verification_strategy": "manual",
"verification_prefix": null,
"verification_token": null,
"created_at": "2023-11-27T19:07:33.155Z",
"updated_at": "2023-11-27T19:07:33.155Z"
}
],
"created_at": "2023-11-16T16:32:25.239Z",
"updated_at": "2023-11-16T17:32:25.239Z"
},
"created_at": "2023-11-16T17:32:25.239Z",
"context": {}
}

Organization deleted

Event name: organization.deleted

Triggered when an organization is deleted.

Payload data corresponds to the Organization object.

Organization deleted
JSON
{
"event": "organization.deleted",
"id": "event_04FKJ843CVE8F7BXQSPFH0M30K",
"data": {
"id": "org_01HV1VNQBQ24JVREYB94RFCNDC",
"name": "Foo Corp",
"object": "organization",
"external_id": null,
"domains": [
{
"id": "org_domain_01HV1VX5N18E48ETTHNNK54R6S",
"state": "verified",
"domain": "foo-corp.com",
"object": "organization_domain",
"organization_id": "org_01HV1VNQBQ24JVREYB94RFCNDC",
"verification_strategy": "manual"
}
],
"created_at": "2023-11-16T16:32:25.239Z",
"updated_at": "2023-11-16T17:32:25.239Z"
},
"created_at": "2023-11-16T17:32:25.239Z",
"context": {}
}
© WorkOS, Inc.
FeaturesAuthKitSingle Sign-OnDirectory SyncAdmin PortalFine-Grained Authorization
DevelopersDocumentationChangelogAPI Status
ResourcesBlogPodcastPricingSecuritySupport
CompanyAboutCustomersCareersLegalPrivacy
© WorkOS, Inc.