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

User events

Events emitted when AuthKit users are changed.

On this page

  • User created
  • User deleted
  • User updated

Events emitted when AuthKit users are created, updated, or deleted.

User created

Event name: user.created

Triggered when a user is created.

Payload data corresponds to the User object.

User created event
JSON
{
"event": "user.created",
"id": "event_02F4KLW3C56P083X43JQXF4FO9",
"data": {
"object": "user",
"id": "user_01E4ZCR3C5A4QZ2Z2JQXGKZJ9E",
"email": "todd@example.com",
"first_name": "Todd",
"last_name": "Rundgren",
"email_verified": false,
"profile_picture_url": "https://workoscdn.com/images/v1/123abc",
"created_at": "2023-11-18T09:18:13.120Z",
"updated_at": "2023-11-18T09:18:13.120Z"
},
"created_at": "2023-11-18T04:18:13.126Z",
"context": {
"client_id": "client_123456789"
}
}

User deleted

Event name: user.deleted

Triggered when a user is deleted.

Payload data corresponds to the User object.

User deleted event
JSON
{
"event": "user.deleted",
"id": "event_123456abcd",
"data": {
"object": "user",
"id": "user_01E4ZCR3C5A4QZ2Z2JQXGKZJ9E",
"email": "todd@example.com",
"first_name": "Todd",
"last_name": "Rundgren",
"email_verified": true,
"profile_picture_url": "https://workoscdn.com/images/v1/123abc",
"created_at": "2023-11-16T21:26:25.427Z",
"updated_at": "2023-11-17T04:00:03.937Z"
},
"created_at": "2023-11-18T04:18:13.126Z",
"context": {}
}

User updated

Event name: user.updated

Triggered when a user is updated.

Payload data corresponds to the User object.

User updated event
JSON
{
"event": "user.updated",
"id": "event_02F4KLW3C56P083X43JQXF4FO9",
"data": {
"object": "user",
"id": "user_01E4ZCR3C5A4QZ2Z2JQXGKZJ9E",
"email": "todd@example.com",
"first_name": "Todd",
"last_name": "Rundgren",
"email_verified": true,
"profile_picture_url": "https://workoscdn.com/images/v1/123abc",
"created_at": "2023-11-18T09:18:13.120Z",
"updated_at": "2023-11-19T11:05:10.539Z"
},
"created_at": "2023-11-19T11:05:10.550Z",
"context": {}
}
© WorkOS, Inc.
FeaturesAuthKitSingle Sign-OnDirectory SyncAdmin PortalFine-Grained Authorization
DevelopersDocumentationChangelogAPI Status
ResourcesBlogPodcastPricingSecuritySupport
CompanyAboutCustomersCareersLegalPrivacy
© WorkOS, Inc.