Organization events track administrative actions related to organization configuration, domain management, and member access views. These events record changes to organization settings and views of organization-level information.
organization.create Records when a new organization is created during user onboarding.
Triggered When User completes the onboarding flow and creates their first organization.
Event Schema Organization’s unique identifier
Empty object (no additional metadata)
Page route where organization was created (typically onboarding flow route)
Example Event { "action" : "organization.create" , "occurredAt" : "2025-01-15T10:30:00.000Z" , "version" : 1 , "actor" : { "type" : "user" , "id" : "user_01JGXYZ123" , "name" : "Alice Johnson" , "metadata" : { "first_name" : "Alice" , "last_name" : "Johnson" , "email" : "[email protected] " , "impersonator_email" : "" , "impersonator_reason" : "" } }, "targets" : [ { "type" : "organization" , "id" : "org_01JGXYZ456" , "name" : "Acme Corp" , "metadata" : {} } ], "context" : { "location" : "192.0.2.1" , "userAgent" : "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)..." }, "metadata" : { "source" : "/onboarding" } }
organization.update_name Records when an organization’s name is changed.
Triggered When Admin updates the organization name in organization settings.
Event Schema Organization’s unique identifier
Organization’s new name (post-update)
Organization’s previous name
Always organization_settings
Example Event { "action" : "organization.update_name" , "occurredAt" : "2025-01-15T14:20:00.000Z" , "version" : 1 , "actor" : { "type" : "user" , "id" : "user_01JGXYZ123" , "name" : "Alice Johnson" , "metadata" : { "first_name" : "Alice" , "last_name" : "Johnson" , "email" : "[email protected] " , "impersonator_email" : "" , "impersonator_reason" : "" } }, "targets" : [ { "type" : "organization" , "id" : "org_01JGXYZ456" , "name" : "Acme Corporation" , "metadata" : { "old_name" : "Acme Corp" , "new_name" : "Acme Corporation" } } ], "context" : { "location" : "192.0.2.1" , "userAgent" : "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)..." }, "metadata" : { "source" : "organization_settings" } }
organization.view_settings Records when a user views the organization settings page.
Triggered When User navigates to the organization details/settings page.
Event Schema organization.view_settings
Organization’s unique identifier
Organization name (duplicated for consistency)
Page route (e.g., /organizations/[orgId]/details)
Example Event { "action" : "organization.view_settings" , "occurredAt" : "2025-01-15T09:15:00.000Z" , "version" : 1 , "actor" : { "type" : "user" , "id" : "user_01JGXYZ123" , "name" : "Alice Johnson" , "metadata" : { "first_name" : "Alice" , "last_name" : "Johnson" , "email" : "[email protected] " , "impersonator_email" : "" , "impersonator_reason" : "" } }, "targets" : [ { "type" : "organization" , "id" : "org_01JGXYZ456" , "name" : "Acme Corp" , "metadata" : { "name" : "Acme Corp" } } ], "context" : { "location" : "192.0.2.1" , "userAgent" : "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)..." }, "metadata" : { "source" : "/organizations/org_01JGXYZ456/details" } }
organization.view_domains Records when a user views the organization’s domain management page.
Triggered When User navigates to the organization domains page.
Event Schema organization.view_domains
Organization’s unique identifier
Organization name (duplicated for consistency)
Page route (e.g., /organizations/[orgId]/domains)
Example Event { "action" : "organization.view_domains" , "occurredAt" : "2025-01-15T11:45:00.000Z" , "version" : 1 , "actor" : { "type" : "user" , "id" : "user_01JGXYZ123" , "name" : "Alice Johnson" , "metadata" : { "first_name" : "Alice" , "last_name" : "Johnson" , "email" : "[email protected] " , "impersonator_email" : "" , "impersonator_reason" : "" } }, "targets" : [ { "type" : "organization" , "id" : "org_01JGXYZ456" , "name" : "Acme Corp" , "metadata" : { "name" : "Acme Corp" } } ], "context" : { "location" : "192.0.2.1" , "userAgent" : "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)..." }, "metadata" : { "source" : "/organizations/org_01JGXYZ456/domains" } }
organization.delete_domain Records when a domain is removed from an organization.
Triggered When Admin deletes a verified domain from the organization’s domain list.
Event Schema organization.delete_domain
Show organization_domain target
Domain’s unique identifier
Domain name (e.g., example.com)
Domain’s unique identifier (same as id)
Organization’s unique identifier
Page route where domain was deleted
Example Event { "action" : "organization.delete_domain" , "occurredAt" : "2025-01-15T16:00:00.000Z" , "version" : 1 , "actor" : { "type" : "user" , "id" : "user_01JGXYZ123" , "name" : "Alice Johnson" , "metadata" : { "first_name" : "Alice" , "last_name" : "Johnson" , "email" : "[email protected] " , "impersonator_email" : "" , "impersonator_reason" : "" } }, "targets" : [ { "type" : "organization_domain" , "id" : "domain_01JGXYZ789" , "name" : "old-domain.com" , "metadata" : { "domain_id" : "domain_01JGXYZ789" , "domain_name" : "old-domain.com" , "organization_id" : "org_01JGXYZ456" } } ], "context" : { "location" : "192.0.2.1" , "userAgent" : "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)..." }, "metadata" : { "source" : "/organizations/org_01JGXYZ456/domains" } }
organization.list_memberships Records when a user views the list of organization members.
Triggered When User queries the organization members list via the members API endpoint.
Event Schema organization.list_memberships
Organization’s unique identifier
Organization name (duplicated for consistency)
Page route where members were listed
Page number in pagination (as string)
Number of results per page (as string)
Total number of members returned (as string)
Search query used to filter members (empty string if no filter)
Example Event { "action" : "organization.list_memberships" , "occurredAt" : "2025-01-15T13:30:00.000Z" , "version" : 1 , "actor" : { "type" : "user" , "id" : "user_01JGXYZ123" , "name" : "Alice Johnson" , "metadata" : { "first_name" : "Alice" , "last_name" : "Johnson" , "email" : "[email protected] " , "impersonator_email" : "" , "impersonator_reason" : "" } }, "targets" : [ { "type" : "organization" , "id" : "org_01JGXYZ456" , "name" : "Acme Corp" , "metadata" : { "name" : "Acme Corp" } } ], "context" : { "location" : "192.0.2.1" , "userAgent" : "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)..." }, "metadata" : { "source" : "/organizations/org_01JGXYZ456/members" , "page" : "1" , "limit" : "50" , "total_results" : "12" , "query" : "" } }
organization.list_workos_events Records when a user views the organization’s audit log events.
Triggered When User queries the audit log events via the WorkOS events API endpoint.
Event Schema organization.list_workos_events
Organization’s unique identifier
Organization name (duplicated for consistency)
Page route where events were viewed
First chunk of event type filters (comma-separated, max 500 chars)
Second chunk of event type filters (if first chunk exceeded 500 chars)
Third chunk of event type filters (if second chunk exceeded 500 chars)
Number of events requested (as string)
Total number of events returned (as string)
Start of date range filter (ISO 8601 timestamp, empty if not specified)
End of date range filter (ISO 8601 timestamp, empty if not specified)
Pagination cursor for next page (empty if not specified)
Example Event { "action" : "organization.list_workos_events" , "occurredAt" : "2025-01-15T15:00:00.000Z" , "version" : 1 , "actor" : { "type" : "user" , "id" : "user_01JGXYZ123" , "name" : "Alice Johnson" , "metadata" : { "first_name" : "Alice" , "last_name" : "Johnson" , "email" : "[email protected] " , "impersonator_email" : "" , "impersonator_reason" : "" } }, "targets" : [ { "type" : "organization" , "id" : "org_01JGXYZ456" , "name" : "Acme Corp" , "metadata" : { "name" : "Acme Corp" } } ], "context" : { "location" : "192.0.2.1" , "userAgent" : "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)..." }, "metadata" : { "source" : "/organizations/org_01JGXYZ456/logs" , "events_1" : "api_key.create, api_key.revoke, project.create" , "events_2" : "" , "events_3" : "" , "limit" : "100" , "total_results" : "47" , "range_start" : "2025-01-01T00:00:00.000Z" , "range_end" : "2025-01-15T23:59:59.999Z" , "after" : "" } }
Event type filters are split across events_1, events_2, and events_3 fields because WorkOS has a 500-character limit per metadata field. The event types are comma-separated within each chunk.
organization.create_domains_portal_url Records when an admin generates a URL to access the WorkOS domains management portal.
Triggered When Admin requests access to the WorkOS self-service domain verification portal.
Event Schema organization.create_domains_portal_url
Organization’s unique identifier
Organization name (duplicated for consistency)
Page route where portal URL was generated
Example Event { "action" : "organization.create_domains_portal_url" , "occurredAt" : "2025-01-15T12:00:00.000Z" , "version" : 1 , "actor" : { "type" : "user" , "id" : "user_01JGXYZ123" , "name" : "Alice Johnson" , "metadata" : { "first_name" : "Alice" , "last_name" : "Johnson" , "email" : "[email protected] " , "impersonator_email" : "" , "impersonator_reason" : "" } }, "targets" : [ { "type" : "organization" , "id" : "org_01JGXYZ456" , "name" : "Acme Corp" , "metadata" : { "name" : "Acme Corp" } } ], "context" : { "location" : "192.0.2.1" , "userAgent" : "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)..." }, "metadata" : { "source" : "/organizations/org_01JGXYZ456/domains" } }
