APIs & Integrations
Workday (OAuth)
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-Requisites | Status | Comment |
---|---|---|
Paid dev account | ✅ Required | You need to be a Workday customer to access developer resources. |
Paid test account | ✅ Required | Test 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
- Log in to your Workday tenant as an administrator.
- In the Search bar, type Register API Client and select it.
2
Create OAuth 2.0 credentials
- 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.
- 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
Useful links
- Workday REST Services Directory
Contribute useful links 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