Skip to content
← All connectors
Developer

WorkOS

Use WorkOS with AI apps and agents through Vercel Connect. Follow a complete setup guide for secure runtime access.

Create Connector

  1. Install the skill

    $ npx skills add vercel/vercel-plugin --skill vercel-connect

  2. Connect to WorkOS

    Via CLIVercel Dashboard(opens in new tab)
    $ vercel connect create workos --name acme-workos

  3. Use its data in agents(opens in new tab) and apps(opens in new tab)

    import { getToken } from '@vercel/connect';
    

    const userId = 'user_123';
    

    const token = await getToken('workos/acme-workos', {
      subject: { type: 'user', id: userId },
    });

Use WorkOS in apps and agents

Authenticate users with SSO and directory sync.

Why use Vercel Connect with WorkOS?

  • Credentials on demand

    Request WorkOS credentials only when your application or agent needs them instead of copying secrets into application code.

  • Access for the right subject

    Request user-authorized WorkOS access so actions follow the identity and permissions of the person using your application.

  • Managed authorization lifecycle

    Centralize WorkOS authorization and token exchange rather than rebuilding the provider flow in every application.

  • Vercel-native controls

    Bind connections to the projects and environments that need them while Vercel OIDC authenticates each runtime request.

Use WorkOS with your stack

Follow a complete setup for the Connect SDK or a supported agent framework.

Add WorkOS to an existing Vercel application with the Connect SDK.

  1. Install the Connect SDK

    npm install @vercel/connect

  2. Create the WorkOS connector

    Run these commands from the project that will use the connection.

    vercel link
    vercel connect create workos --name acme-workos
    vercel env pull

  3. Request WorkOS credentials

    app/api/route.ts
    import { getToken } from '@vercel/connect';
    

    const userId = 'user_123';
    

    const token = await getToken('workos/acme-workos', {
      subject: { type: 'user', id: userId },
    });

More connectors like WorkOS

Browse all connectors