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 domain events

Events emitted when organization domains are changed.

On this page

  • Organization domain created
  • Organization domain updated
  • Organization domain deleted
  • Organization domain verified
  • Organization domain verification failed

Events emitted when organization domains are created, updated, deleted, or their verification status changes.

Organization domain created

organization_domain.created

Triggered when an organization domain is created.

Payload data corresponds to the Organization Domain object.

Organization domain created event
JSON
{
"event": "organization_domain.created",
"id": "event_01G69A9MDSW8MM1XW5S0EHA0NA",
"data": {
"object": "organization_domain",
"id": "org_domain_01EZTR5N6Y9RQKHK2E9F31KZX6",
"organization_id": "org_01EHWNCE74X7JSDV0X3SZ3KJNY",
"domain": "foo-corp.com",
"state": "pending",
"verification_token": "gBIJgYXZLjW8uHHpz614dkgqm",
"verification_strategy": "dns",
"verification_prefix": "superapp-domain-verification-z3kjny",
"created_at": "2023-11-27T19:07:33.155Z",
"updated_at": "2023-11-27T19:07:33.155Z"
},
"created_at": "2023-11-27T19:07:33.155Z",
"context": {}
}

Organization domain updated

organization_domain.updated

Triggered when an organization domain is updated.

Payload data corresponds to the Organization Domain object.

Organization domain updated event
JSON
{
"event": "organization_domain.updated",
"id": "event_01G69A9MDSW8MM1XW5S0EHA0NA",
"data": {
"object": "organization_domain",
"id": "org_domain_01EZTR5N6Y9RQKHK2E9F31KZX6",
"organization_id": "org_01EHWNCE74X7JSDV0X3SZ3KJNY",
"domain": "foo-corp.com",
"state": "verified",
"verification_prefix": "superapp-domain-verification-z3kjny",
"verification_token": "gBIJgYXZLjW8uHHpz614dkgqm",
"verification_strategy": "dns",
"created_at": "2022-11-27T19:07:33.155Z",
"updated_at": "2023-11-27T19:07:33.155Z"
},
"created_at": "2023-11-27T19:07:33.155Z",
"context": {}
}

Organization domain deleted

organization_domain.deleted

Triggered when an organization domain is deleted.

Payload data corresponds to the Organization Domain object.

Organization domain deleted event
JSON
{
"event": "organization_domain.deleted",
"id": "event_01G69A9MDSW8MM1XW5S0EHA0NA",
"data": {
"object": "organization_domain",
"id": "org_domain_01EZTR5N6Y9RQKHK2E9F31KZX6",
"organization_id": "org_01EHWNCE74X7JSDV0X3SZ3KJNY",
"domain": "foo-corp.com",
"state": "verified",
"verification_prefix": "superapp-domain-verification-z3kjny",
"verification_token": "gBIJgYXZLjW8uHHpz614dkgqm",
"verification_strategy": "dns",
"created_at": "2022-11-27T19:07:33.155Z",
"updated_at": "2023-11-27T19:07:33.155Z"
},
"created_at": "2023-11-27T19:07:33.155Z",
"context": {}
}

Organization domain verified

organization_domain.verified

Triggered when an organization domain is verified.

Payload data corresponds to the Organization Domain object.

Organization domain verified event
JSON
{
"event": "organization_domain.verified",
"id": "event_07FKJ843CVE8F7BXQSPFH0M53A",
"data": {
"object": "organization_domain",
"id": "org_domain_01HACSKJ57W8M2Q0N2X759C5HS",
"organization_id": "org_01EHT88Z8J8795GZNQ4ZP1J81T",
"domain": "foo-corp.com",
"state": "verified",
"verification_prefix": "superapp-domain-verification-z3kjny",
"verification_token": "gBIJgYXZLjW8uHHpz614dkgqm",
"verification_strategy": "dns",
"created_at": "2022-11-27T19:07:33.155Z",
"updated_at": "2023-11-27T19:07:33.155Z"
},
"created_at": "2021-06-25T19:07:33.155Z",
"context": {}
}

Organization domain verification failed

organization_domain.verification_failed

Triggered when an organization domain verification fails.

Payload data contains a reason and an organization_domain which corresponds to the Organization Domain object.

Organization domain verification failed event
JSON
{
"event": "organization_domain.verification_failed",
"id": "event_07FKJ843CVE8F7BXQSPFH0M53A",
"data": {
"reason": "domain_verification_period_expired",
"organization_domain": {
"object": "organization_domain",
"id": "org_domain_01HACSKJ57W8M2Q0N2X759C5HS",
"organization_id": "org_01EHT88Z8J8795GZNQ4ZP1J81T",
"domain": "foo-corp.com",
"state": "failed",
"verification_token": "gBIJgYXZLjW8uHHpz614dkgqm",
"verification_strategy": "dns"
}
},
"created_at": "2021-06-25T19:07:33.155Z",
"context": {}
}
© WorkOS, Inc.
FeaturesAuthKitSingle Sign-OnDirectory SyncAdmin PortalFine-Grained Authorization
DevelopersDocumentationChangelogAPI Status
ResourcesBlogPodcastPricingSecuritySupport
CompanyAboutCustomersCareersLegalPrivacy
© WorkOS, Inc.