Workday

​

Workday OAuth Setup

​

Step 1: Find Your Tenant and REST API Endpoint

1. Log in to Workday
2. Search for the View API Clients task
3. Note your Tenant name and the Workday REST API Endpoint (for example, https://wd2-impl-services1.workday.com/ccx/api/v1/yourtenant)

​

Step 2: Register an API Client

1. Search for and open the Register API Client for Integrations task
2. Enter a Client Name (e.g., BonData Integration)
3. Set the Non-Expiring Refresh Tokens option as needed
4. Select the required Functional Areas / Scopes (for example, Staffing, Compensation, and Financial Accounting)
5. Click OK
6. Copy the Client ID and Client Secret shown on the confirmation screen

​

Step 3: Generate a Refresh Token

1. Search for the View API Clients task and open your registered client
2. Under API Clients for Integrations, select Manage Refresh Tokens for Integrations
3. Choose the integration system user and generate a refresh token
4. Copy the Refresh Token - it is only shown once

​

Step 4: Enter Credentials in BonData

1. In BonData, navigate to Integrations and select Workday
2. Enter your Tenant, REST API Endpoint, Client ID, Client Secret, and Refresh Token
3. Click Connect

​

Required Fields

​

Available Data

• Workers - Employee and contingent worker records
• Organizations - Supervisory, company, and cost center organizations
• Positions - Positions and job profiles
• Compensation - Compensation plans and grades
• Time Off - Time off and absence records
• Financial Accounts - Ledger accounts and financial dimensions