WorkOS

🚀 Quickstart

Connect to WorkOS with Nango and see data flow in 2 minutes.

Create the integration

In Nango (free signup), go to Integrations -> Configure New Integration -> WorkOS.

Authorize WorkOS

Go to Connections -> Add Test Connection -> Authorize, then enter your API key. Later, you’ll let your users do the same directly from your app.

Call the WorkOS API

Let’s make your first request to the WorkOS API (list connections). Replace the placeholders below with your secret key, integration ID, and connection ID:

cURL
Node

curl "https://api.nango.dev/proxy/connections?limit=1" \
  -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>"

Install Nango’s backend SDK with npm i @nangohq/node. Then run:

import { Nango } from '@nangohq/node';

const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

const res = await nango.get({
    endpoint: '/connections',
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<CONNECTION-ID>',
    params: { limit: '1' }
});

console.log(res.data);

Or fetch credentials with the Node SDK or API.✅ You’re connected! Check the Logs tab in Nango to inspect requests.

Implement Nango in your app

Follow our Auth implementation guide to integrate Nango in your app.To obtain your own production credentials, follow the setup guide linked below.

📚 WorkOS Integration Guides

Nango-maintained guides for common use cases.

How to obtain your WorkOS API key
Get your WorkOS API key to connect it to Nango

Official docs: WorkOS API Reference

🧩 Pre-built syncs & actions for WorkOS

Enable them in your dashboard. Extend and customize to fit your needs. No pre-built syncs or actions available yet.

Not seeing the integration you need? Build your own independently.

API Guides

APIs & Integrations

🚀 Quickstart

📚 WorkOS Integration Guides

🧩 Pre-built syncs & actions for WorkOS

API Guides

APIs & Integrations

​🚀 Quickstart

​📚 WorkOS Integration Guides

​🧩 Pre-built syncs & actions for WorkOS

🚀 Quickstart

📚 WorkOS Integration Guides

🧩 Pre-built syncs & actions for WorkOS