Workday (OAuth)

🚀 Quickstart

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

Create an integration

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

Authorize Workday

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

Call the Workday API

Let’s make your first request to the Workday API (fetch worker information). Replace the placeholders below with your secret key, integration ID, and connection ID:

cURL
Node

curl "https://api.nango.dev/proxy/v1/{connectionConfig.tenant}/workers" \
  -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 connectionId = '<CONNECTION-ID>';
const providerConfigKey = '<INTEGRATION-ID>';
const connection = await nango.getConnection(providerConfigKey, connectionId);

const res = await nango.get({
    endpoint: `/v1/${connection.connection_config['tenant']}/workers`,
    providerConfigKey,
    connectionId
});

console.log(JSON.stringify(res.data, null, 2));

Or fetch credentials dynamically via the Node SDK or API.

The {connectionConfig.tenant} in the URL represents the tenant. You can get this value from your connection configuration after creating the connection.

Implement Nango in your app

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

✅ You’re connected! Check the Logs tab in Nango to inspect requests.

Next step: Embed the auth flow in your app to let your users connect their Workday accounts.

📚 Workday Integration Guides

Nango maintained guides for common use cases.

How to register your own Workday OAuth app
Register an OAuth app with Workday and obtain credentials to connect it to Nango
How do I link my Workday account?
Learn how to authenticate with Workday and link your account

Official docs: Workday REST Services Directory

🚨 API Gotchas

Workday provides two APIs, a REST and a SOAP one and Nango supports them both.
Access to most of Workday’s API doc resources, including detailed documentation on OAuth authentication flows, is typically restricted to Workday customers and partners. To access these resources, you can:
1. Sign In to Workday Community: Visit the Workday Community and sign in with your Workday credentials. If you don’t have an account, you can request one.
2. Contact Workday Support: If you are a customer, reach out to Workday Support for assistance in accessing specific documentation.

API Guides

APIs & Integrations

🚀 Quickstart

📚 Workday Integration Guides

🚨 API Gotchas

API Guides

APIs & Integrations

​🚀 Quickstart

​📚 Workday Integration Guides

​🚨 API Gotchas

🚀 Quickstart

📚 Workday Integration Guides

🚨 API Gotchas