WorkOS Integrations

Step 1: Identify the Provider

Ask the user which identity provider they need to integrate. Then find it in the table below.

Provider Lookup

General Integration Flow

1. •WebFetch the provider-specific doc URL from the table above
2. •Follow the setup steps in the fetched documentation
3. •Configure the connection in the WorkOS Dashboard
4. •Test the integration with a test user

Integration Type Decision Tree

What type of integration?
  |
  +-- SSO (user login)
  |     |
  |     +-- Provider supports SAML? → Use SAML connection
  |     +-- Provider supports OIDC? → Use OIDC connection
  |     +-- Provider supports both? → Prefer SAML (more enterprise-ready)
  |
  +-- Directory Sync (user provisioning)
  |     |
  |     +-- Provider supports SCIM? → Use SCIM connection
  |     +-- No SCIM? → Check for custom directory sync option
  |
  +-- OAuth (social login)
        |
        +-- Find provider in OAuth section of table
        +-- Configure OAuth app in provider's developer console
        +-- Add credentials to WorkOS Dashboard

Common Setup Patterns

SAML Configuration

Most SAML providers require:

1. •An ACS URL (from WorkOS Dashboard)
2. •An SP Entity ID (from WorkOS Dashboard)
3. •IdP metadata URL or certificate upload

SCIM Directory Setup

Most SCIM providers require:

1. •A SCIM endpoint URL (from WorkOS Dashboard)
2. •A Bearer token for authentication
3. •User attribute mapping configuration

OAuth Setup

Most OAuth providers require:

1. •Create an OAuth app in the provider's developer console
2. •Set the redirect URI from WorkOS Dashboard
3. •Copy Client ID and Secret to WorkOS

Verification

• • Connection appears in WorkOS Dashboard
• • Test SSO login succeeds with a test user
• • User profile attributes map correctly
• • (If SCIM) Directory sync shows users from provider

Related Skills

• •workos-sso: General SSO implementation and configuration
• •workos-directory-sync: Directory Sync setup and management
• •workos-domain-verification: Domain verification required for SSO