Linking WorkOS as a source
Let AI connect your sources for you
Skip the manual setup — run this in your project and the wizard auto-detects your databases and APIs and connects them to PostHog.
Contents
Enter your WorkOS API key to sync your WorkOS data into the PostHog data warehouse.
Adding a data source
- Go to the sources tab of the data pipeline section in PostHog.
- Click + New source and then click Link next to WorkOS.
- Find your API key in the WorkOS Dashboard under API Keys. The key starts with
sk_. - Back in PostHog, paste the key in the
API keyfield and click Next. - Select the tables you want to sync, set the sync method and frequency, then click Import.
Once the syncs are complete, you can start using WorkOS data in PostHog.
Available tables
| Table | Description | Sync method |
|---|---|---|
organizations | Organizations in your WorkOS account | Full refresh |
users | Users managed via WorkOS User Management | Full refresh |
connections | SSO connections | Full refresh |
directories | Directory Sync directories | Full refresh |
directory_users | Users synced from connected directories | Full refresh |
directory_groups | Groups synced from connected directories | Full refresh |
Incremental tables sync only new or updated records on each run. Full refresh tables reload all data on each sync.
Configuration
| Option | Type | Required |
|---|---|---|
API key | password | Yes |
Supported tables
| Table | Description | Sync method | Incremental field | Primary key |
|---|---|---|---|---|
organizations | An organization (a tenant/company) in WorkOS that users and connections belong to. | Webhook, Full refresh | — | — |
users | A user managed by WorkOS User Management (AuthKit). | Webhook, Full refresh | — | — |
connections | An SSO connection between an organization and an identity provider. | Full refresh | — | — |
directories | A directory connection used for Directory Sync (SCIM) with an organization. | Full refresh | — | — |
directory_users | A user synced from an organization's directory via Directory Sync. | Webhook, Full refresh | — | — |
directory_groups | A group synced from an organization's directory via Directory Sync. | Webhook, Full refresh | — | — |