Overview

Pre-built tooling

Pre-built integrations

No pre-built integration yet (time to contribute: <48h)

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

Access requirements

Pre-RequisitesStatusComment
Paid dev account✅ RequiredYou need to be a Workday customer to access developer resources.
Paid test account✅ RequiredTest environments are typically provisioned by Workday for customers.
App review✅ Not required
App review✅ Not required
Security audit✅ Not required

Setup guide

1

Access the Workday API Client Registration

  1. Log in to your Workday tenant as an administrator.
  2. In the Search bar, type Register API Client and select it.
2

Create OAuth 2.0 credentials

  1. On the Register API Client page, configure:
  • Client Name: Enter a unique, descriptive name (e.g., Nango HRIS Integration).
  • Client Grant Type: Select Authorization Code Grant (required for OAuth 2.0 flows).
  • Access Token Type: Select Bearer (standard for API authentication).
  • Redirection URI: Set to https://api.nango.dev/oauth/callback.
  • Non-Expiring Refresh Tokens: ✅ Enable (recommended for long-lived access).
  • Scope (Functional Areas):
    • Custom Objects > System (required for custom object operations).
    • System - Workday Query Language (WQL) (required for WQL queries).
    • HRIS (for core employee/personnel data).
    • Staffing (for recruitment/hiring data).
    • Tenant Non-Configurable (read-only tenant settings).
  • Include Workday Owned Scope: ⚠️ Optional, It grants access to API scopes that are owned and managed by Workday itself.
  1. Click OK to generate client credentials (Client ID and Client Secret), save these credentials securely as you’ll need them when configuring your integration in Nango.
3

Next

Follow the Quickstart.

Need help getting started? Get help in the community.
Contribute improvements to the setup guide by editing this page

API gotchas

  • Access to most 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:​
  • 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.
  • Contact Workday Support: If you are a customer, reach out to Workday Support for assistance in accessing specific documentation.

Add Getting Started links and Gotchas by editing this page

Going further

Connect to Workday (OAuth)

Guide to connect to Workday (OAuth) using Connect UI