Skip to main content

What You'll Need

CredentialDescription
Client IDOAuth 2.0 client ID for REST API
Client SecretOAuth 2.0 client secret for REST API
Tenant NameWorkday tenant identifier (used in URL: https://{tenant}.workday.com)
Username(Optional) HTTP Basic username for RaaS custom reports
Password(Optional) HTTP Basic password for RaaS custom reports
RaaS Base URL(Optional) Custom report base URL for RaaS endpoints
Report Owner(Optional) Workday user who owns the custom report
Report Name(Optional) Name of the RaaS custom report

​
Overview

Connect to Workday via OAuth 2.0 client credentials for reliable, long-lived API access to HR data.

Workers & Orgs

Employee profiles, org hierarchy

Time & Attendance

Time off balances, requests, schedules

​
Prerequisites

Administrator access required. You need privileges in to complete this setup.If you don’t have admin access, contact your administrator to:
  • Create the API credentials on your behalf, OR
  • Grant you temporary admin access to complete the setup
  • Integration System Administrator security role in Workday
  • Access to register API clients
  • Understanding of Workday’s domain structure

​
Setup Guide

1

Register API Client

  1. In Workday, search for: Register API Client for Integrations
  2. Click the task
  3. Fill in:
FieldValue
Client NameParable Integration
Functional AreasSelect relevant areas (see below)
2

Select Functional Areas

Enable access to:
  • ✅ Human Resources
  • ✅ Staffing
  • ✅ Absence
  • ✅ Organization
Click Done
3

Copy Client Credentials

After registration, Workday displays:
  • Client ID
  • Client Secret
Copy these immediately — the Client Secret is only shown once!
4

Create Integration System User

  1. Search: Create Integration System User
  2. Create a dedicated user for the integration
  3. Set a strong password
  4. Note the username
5

Configure Security Groups

  1. Search: Create Security Group
  2. Create an Integration Security Group
  3. Assign the Integration System User
  4. Grant necessary domain permissions for:
    • Worker Data (READ)
    • Organization (READ)
    • Absence (READ)
6

Note Your Tenant URL

Your Workday tenant URL follows this pattern:
https://wd5-impl-services1.workday.com/ccx/api/v1/YOUR_TENANT
Replace YOUR_TENANT with your tenant name and adjust the data center as needed.