Auth & Identity
WorkOS Webhooks
Enterprise auth platform. Receive events for SSO, directory sync, audit logs, and user management.
Connecting WorkOS to Hookbase
Create a source in Hookbase first — it gives you an ingest URL to paste into WorkOS. Then:
- 1Go to WorkOS Dashboard → Webhooks
- 2Click "Create Endpoint" and paste your Hookbase ingest URL
- 3Copy the signing secret and add it to your Hookbase source
- 4Select the events you want to subscribe to
Signature verification
Set the source's provider to workos and paste the signing secret. Every request is checked before the event is stored, and anything that fails is rejected rather than quietly recorded.
- Algorithm
- HMAC-SHA256 with timestamp
- Header
- WorkOS-Signature
- Where to find the secret
- WorkOS Dashboard → Webhooks → Endpoint → Signing Secret
WorkOS event types
8 of the events people route most often. Hookbase accepts every event WorkOS sends, whether or not it is listed here.
dsync.user.created
A directory user was created
dsync.user.updated
A directory user was updated
dsync.user.deleted
A directory user was deleted
dsync.group.created
A directory group was created
dsync.group.updated
A directory group was updated
connection.activated
An SSO connection was activated
connection.deactivated
An SSO connection was deactivated
authentication.email_verification_succeeded
Email verification succeeded
What a WorkOS webhook looks like
A dsync.user.created payload. Hookbase stores the raw body exactly as it arrived, so this is also what you get back on a replay.
{
"id": "event_01H8MWQR4XJ3FQKXRB3V2QY4N6",
"event": "dsync.user.created",
"created_at": "2024-01-15T10:30:00.000Z",
"data": {
"id": "directory_user_01H8MWQR4XJ3FQKXRB3V2QY4N6",
"directory_id": "directory_01H8MWQR4XJ3FQKXRB3V2QY4N6",
"first_name": "Jane",
"last_name": "Developer",
"emails": [
{
"type": "work",
"value": "jane@example.com",
"primary": true
}
],
"state": "active"
}
}Start receiving WorkOS webhooks
Create a source, paste the URL into WorkOS, and watch the first event arrive. The free tier includes 1,000 events a month.
Get Started Free