How to Register a Workday Developer App and Get OAUTH2/ SOAP Credentials

Updated:


November 10, 2025

How to Register and Get OAUTH2 Credentials for Workday:

Updated:

You will need 3 endpoints (URLs):

  • REST API Endpoint
  • Token Endpoint
  • Authorization Endpoint

You will also need:

  • Client ID
  • Client Secret

How to setup Client ID

  1. Log in to the Workday application
  2. Register API Client: Navigate to the "Register API Client" section
  3. Select the Register API Client form
  4. Select the Register API Client form
  5. For the grant type, select "Authorization Code Grant'
  6. For the access token type, select "Bearer'
  7. In the Redirection URI field, enter https://api.unified.to/oauth/code
  8. In the Scope section, add Staffing and/or Recruiting, depending on your application's needs
  9. Select "Non-expiring Refresh Tokens'
  10. Select the Include Workday Owned Scope checkbox.

Click OK to save the app.

image.png

Once you create your application, Workday will display the information that you entered plus additional information.

Retrieve Endpoints

  1. Access "View API Clients"
  2. Use the Workday search bar to navigate to "View API clients"
  3. Retrieve REST API Endpoint, Token Endpoint, Authorization Endpoint

How to Connect Workday (Legacy) — SOAP Web Services with an Integration System User

Updated:

Workday (Legacy) connects to Workday Web Services (SOAP) with an Integration System User (ISU). There is no OAuth app to register. You will enter 4 values when connecting:

FieldWhat to enterExample
Workday HostHost name only — no https://, no pathwd2-impl-services1.workday.com (sandbox) or wd5-services1.myworkday.com (production)
Tenant NameYour tenant id from the WSDL URLacmecorp_preview
ISU UsernameThe ISU username only — do not add @tenant (Unified adds it)INT_unified
ISU PasswordThe ISU password

⚠️ The older setup asked for a "WSDL URL". It now asks for Workday Host and Tenant Name separately. If you are connecting through the API, do not send an api_url — just the 4 values above.

Step 1 — Find your Workday Host and Tenant Name

  1. In Workday, search Public Web Services and open the report.
  2. Hover over Human Resources, click the related-actions menu (…) → Web Service → View WSDL.
  3. Scroll to the bottom of the WSDL. The endpoint looks like https://<HOST>/ccx/service/<TENANT>/Human_Resources/v46.1.
  4. Workday Host = <HOST> (e.g. wd2-impl-services1.workday.com). Tenant Name = <TENANT> (e.g. acmecorp_preview).

Sandbox / implementation tenants usually have a host with impl in it; production tenants usually do not. Use the host and tenant of the tenant you want to connect.

Step 2 — Create the Integration System User (ISU)

  1. Search Create Integration System User.
  2. Enter a User Name (e.g. INT_unified) and a strong Password.
  3. Leave Require New Password at Next Sign In unchecked.
  4. Set Session Timeout Minutes to 0.
  5. Check Do Not Allow UI Sessions.
  6. Click OK.

Make sure the ISU password does not expire (exclude the ISU from password-expiry rules, e.g. with Maintain Password Rules). An expired password makes every call fail with "invalid username or password".

Step 3 — Create a security group and add the ISU

  1. Search Create Security Group.
  2. Type: Integration System Security Group (Unconstrained). Use Constrained only if you want to limit which organizations the ISU can see.
  3. Name it (e.g. ISSG Unified) and add the ISU from Step 2 as a member.

Step 4 — Grant domain permissions

Search Maintain Permissions for Security Group, pick the group from Step 3, and add Domain Security Policy Permissions. Give Get for reading and Put for writing, only for the data you need:

Data in UnifiedWorkday web serviceDomains to grant (examples)
Employees, benefits, worker documentsHuman_ResourcesWorker Data: Workers, Worker Data: Public Worker Reports, Person Data: Personal Information, Person Data: Contact Information
Employee SSN / SINHuman_ResourcesThe government / national ID domain (e.g. Person Data: Government IDs)
Companies, locations, groupsHuman_ResourcesSet Up: Organization Structures, location and workteam domains
Positions (hris_job), hiring employeesStaffingPosition access; Manage: Worker as Pre-Hire (Put) for hires
Time offAbsence_ManagementWorker Data: Time Off, Process: Absence Calculation Results
Timeshifts, attendanceTime_TrackingTime tracking / calculated time blocks domain
Payslips, deductionsPayrollWorker Data: Payroll Payslip Information, Set Up: Payroll Deductions
Bank accountsCash_ManagementWorker Data: Payment Election
Reference lists (statuses, leave types)IntegrationsGet References
ATS jobs, candidates, applications, documents, interviews, scorecardsRecruitingSet Up: Recruiting, Worker Data: Recruiting, Manage: Candidate, Process: Recruiting, Job Application: Move Candidate (Put), interview feedback domains
Accounting (customers, suppliers, invoices, payments, payment terms)Revenue_Management, Resource_Management, Financial_ManagementCustomer, Supplier, Customer / Supplier Invoice, Customer Payment, Payment Terms

💡 Domain names can differ slightly between tenants. To find the exact domain an operation needs, search View Security for Securable Item and enter the operation name (e.g. Get_Workers, Get_Candidates, Get_Positions).

Writes that run business processes (e.g. hiring, moving a candidate) also need the ISU's security group added to that business process policy.

Step 5 — Activate the security changes (required)

Search Activate Pending Security Policy Changes, enter a comment, check Confirm, and click OK. Until this runs, every call fails. Run it again whenever you change permissions.

Step 6 — Connect in Unified

Open the Workday (Legacy) connection screen and enter Workday Host, Tenant Name, ISU Username and ISU Password.

Troubleshooting

ErrorCauseFix
invalid username or passwordWrong credentials; username entered as user@tenant; password expired; security changes not activatedRe-enter the username without @tenant; reset the ISU password; run Step 5
The task submitted is not authorizedThe ISU lacks a domain or business-process permissionGrant the domain (Step 4), then run Step 5
DNS lookup failed / host not foundHost typed wrong, or includes https:// / a path from an old setupEnter only the host, e.g. wd2-impl-services1.workday.com
Service UnavailableWorkday maintenance (sandbox tenants have scheduled downtime)Retry later
Connection timed out / host unreachableNetwork block or an IP restriction on the ISU's authentication policyAllow Unified's outbound IPs (contact Unified support for the list) or remove the restriction for the ISU
Some objects return errors or no dataMissing domain permissions, or the Workday module (Recruiting, Time Tracking, Payroll…) is not enabledGrant the domains in Step 4, or skip objects for modules you don't use

How to Connect Workday RaaS — Custom Reports as Web Services

Updated:

Workday RaaS (Report-as-a-Service) reads your data from custom reports that you build in Workday and publish as web services. Use it when you'd rather share specific reports than grant API-client or SOAP access, or when the data you need already lives in your reports. Like Workday (Legacy), it signs in with an Integration System User (ISU), and there is no OAuth app to register.

Each Unified object reads one report:

Data in UnifiedReport to build
Employees (hris_employee)Employees report
Groups / organizations (hris_group)Organizations report
Companies (hris_company)Companies report
Time off (hris_timeoff)Time Off report
Payslips (hris_payslip)Payslips report
You only need the reports for the data you want to share. Workday RaaS is read-only: nothing is created or changed in Workday.

You will enter these values when connecting:

FieldWhat to enterExample
Workday HostHost name only — no https://, no pathwd2-impl-services1.workday.com
Tenant NameYour tenant id (the segment after customreport2/ in a report URL)acmecorp_preview
ISU UsernameThe ISU username only — do not add @tenant (Unified adds it)INT_unified
ISU PasswordThe ISU password
Employees / Organizations / Companies / Time Off / Payslips ReportFor each report you built: its JSON URL (see Step 5), or owner/Report_Name. Leave the others blank.https://wd2-impl-services1.workday.com/ccx/service/customreport2/acmecorp_preview/INT_unified/Unified_Employees?format=json
At least one report is required.

Step 1 — Create the ISU and its security group

Follow Step 2 and Step 3 of the Workday (Legacy) section above. If you already use Workday (Legacy), you can reuse the same ISU.

Step 2 — Grant Get access to the data your reports read

Search Maintain Permissions for Security Group, pick the ISU's security group, and add Get permission on the domains that secure the fields in your reports. For example:

ReportDomains to grant (examples)
EmployeesWorker Data: Public Worker Reports, Worker Data: Workers, Person Data: Personal Information, Person Data: Contact Information, Worker Data: Compensation (for base pay)
Organizations, CompaniesSet Up: Organization Structures
Time OffWorker Data: Time Off
PayslipsWorker Data: Payroll Results / Payroll Payslip Information

💡 A report only returns fields the ISU is allowed to see. Fields it can't see come back empty, with no error. To find the domain that secures a field, search View Security for Securable Item and enter the field name.

Step 3 — Activate the security changes (required)

Search Activate Pending Security Policy Changes, enter a comment, check Confirm, and click OK. Run it again whenever you change permissions.

Step 4 — Build each report

For each report you want to share:

  1. Search Create Custom Report.
  2. Enter a name (e.g. Unified_Employees), set Report Type to Advanced, and check Enable As Web Service.
  3. Pick a data source, e.g. All Active and Terminated Workers for employees or Time Off Entries for time off. Add filters if you only want some rows, e.g. active workers only.
  4. Add one column per field in the tables below. For each column, set Column Heading Override XML Alias to the name in the XML alias column, exactly as written (case-sensitive). Unified reads only these aliases. You can add other columns; they are passed through untouched.
  5. On the Share tab, share the report with the ISU (or its security group).
  6. Click OK.

⚠️ Every report needs its ID column (marked required). Without it, rows have no ID in Unified. Each report returns all its rows in one call, so filter large reports in Workday rather than in your app.

Employees report

XML aliasWhat to put in the column
Employee_ID (required)Employee ID
Full_Name, First_Name, Last_NameLegal or preferred name
Work_Email, Home_EmailPrimary work / home email
Work_Phone, Mobile_Phone, Home_PhonePhone numbers
Business_TitleBusiness title
Manager_IDThe manager's Employee ID
ActiveActive status (Boolean)
Hire_Date, Termination_Date, Termination_ReasonHire date, termination date and reason
Date_of_Birth, GenderDate of birth, gender
Worker_Type, Time_TypeWorker type (Employee / Contingent Worker), time type (Full time / Part time)
Company_IDCompany reference ID
Supervisory_Organization_ID, Supervisory_Organization_NamePrimary supervisory organization
Base_Pay_Amount, Base_Pay_Currency, Base_Pay_FrequencyBase pay, its currency and frequency (e.g. Annual, Hourly)
Address_Line_1, Address_Line_2, City, Region, Postal_Code, CountryPrimary home address (country as a name or ISO code)
Last_UpdatedLast updated date/time

Organizations report

XML aliasWhat to put in the column
Organization_ID (required)Organization reference ID
Organization_Name, DescriptionName, description
Organization_TypeType (Supervisory, Cost Center, Pay Group, Division…)
Superior_Organization_IDParent organization ID
Manager_IDThe manager's Employee ID
Active, Company_ID, Last_UpdatedActive status, company ID, last updated

Companies report

XML aliasWhat to put in the column
Company_ID (required)Company reference ID
Company_Name, Legal_NameName, legal name
Address_Line_1, Address_Line_2, City, Region, Postal_Code, CountryCompany address
Last_UpdatedLast updated date/time

Time Off report

XML aliasWhat to put in the column
Time_Off_Entry_ID (required)Time off entry reference ID
Employee_ID (required)The worker's Employee ID
Start_Date, End_Date — or a single DateDates of the time off
Time_Off_TypeTime off type (e.g. Vacation, Sick)
Quantity, Unit_of_TimeAmount and unit (Hours / Days)
StatusStatus (Approved, Submitted, Denied, Canceled…)
Paid, CommentPaid (Boolean), comment
Approver_ID, Approved_DateApprover's Employee ID, approval date
Company_ID, Last_UpdatedCompany ID, last updated

Payslips report

One row per payslip (payroll result).

XML aliasWhat to put in the column
Payslip_ID (required)Payroll result reference ID
Employee_IDThe worker's Employee ID
Payment_Date, Period_Start_Date, Period_End_DatePayment date, period start and end
Currency, Gross_Amount, Net_AmountCurrency, gross and net pay
Total_HoursHours paid
Employee_Taxes, Employer_Taxes, DeductionsTotals for employee taxes, employer taxes, deductions
Gross_YTD, Net_YTDYear-to-date gross and net
Pay_Group_ID, Company_ID, Last_UpdatedPay group ID, company ID, last updated

Step 5 — Copy each report's URL

Open the report, click the related-actions menu (…) → Web Service → View URLs, and copy the JSON URL. It looks like https://<HOST>/ccx/service/customreport2/<TENANT>/<OWNER>/<REPORT_NAME>?format=json, which also gives you your Workday Host and Tenant Name.

Step 6 — Connect in Unified

Open the Workday RaaS connection screen. Enter Workday Host, Tenant Name, ISU Username and ISU Password, then paste each report's JSON URL into its field (Employees Report, Organizations Report, …).

Troubleshooting

ErrorCauseFix
401 / invalid username or passwordWrong credentials, password expired, or security changes not activatedRe-enter the username without @tenant; reset the ISU password; run Step 3
"No … Report is configured on this connection"That object's report field was left blankBuild the report and add its URL to the connection
"The report URL is for tenant …"The pasted URL is from another tenant (e.g. sandbox vs production)Copy the URL from the tenant you're connecting
"Enter the report as owner/Report_Name…"The report field isn't a report URL or owner/Report_NamePaste the JSON URL from Step 5
404 / report not foundReport renamed, not enabled as a web service, or not shared with the ISUCheck Enable As Web Service and the Share tab (Step 4), then copy the URL again
Rows have no ID, or fields are emptyColumn XML aliases don't match the tables above, or the ISU can't see those fieldsFix the aliases (they're case-sensitive), and grant the domains in Step 2
Slow responses or timeoutsVery large reportAdd filters to the report in Workday
Share
All guidesEmbedded Authorization/Sign-inAuthentication/Sign-in APIsAccounting Account Type Hierarchy in UnifiedAdvertising Report Metrics by IntegrationAmazon S3: Required IAM PermissionsATS to Vector DB: How to Power Talent Intelligence with Real-Time DataBuilding AI applications with Unified and LangbaseConcur & Concur (Company) — Connection GuideConfigure Greenhouse Native Candidate WebhooksConfigure Salesforce Meetings and Notes for UnifiedConnect Amazon Seller Central to Unified.toConnecting BambooHR via OAuth 2Connecting Google Workspace Integrations with a Service AccountCorrect WelcomeKit Scopes for Jungle IntegrationCreating Ads using the Unified Ads APICreating Walmart Items via UnifiedEnd-Users, Integrations, and ConnectionsEnriching Unified Objects with Custom MetadataEnterprise-managed authorization (EMA) with a static keyEnterprise-managed authorization (EMA) with a workspace secretEnterprise-managed authorization (EMA) with Microsoft Entra IDExtended observability — pushing API logs to ClickHouseExtended observability — pushing API logs to Grafana / LokiExtended Observability - Pushing API Logs to your Datadog InstanceFacebook Messenger Webhook SetupFireflies Integration GuideGetting started with WorkableHandling Delegated vs. Application Scopes in Microsoft IntegrationsHiBob & Unified: connection and time off guideHow long are logs retainedHow to access employees and usersHow to add API support for the Create Activity in CrelateHow to Associate a Connection ID with Your End-UserHow to build a Candidate Assessment product withHow to build a candidate sourcing or job board app with Unified.toHow to build a Discord support bot with Unified.to and LangbaseHow to Build a Fintech Application with Unified's Payments APIHow to Build an E-Commerce Product Integration with UnifiedHow to build an invoicing system with Unified.toHow to build Enterprise Search using RAGHow to configure Bullhorn Redirect URI for creating a connectionHow to configure webhooks in HubSpotHow to configure webhooks in Thrive LearningHow to configure webhooks in Toast for UnifiedHow to Connect Anthropic to Real-Time SaaS Data with Unified.to MCP ServerHow to Connect Cohere to Real-Time SaaS Data with Unified.to MCP ServerHow to Connect Google Gemini to Real-Time SaaS Data with Unified.to MCP ServerHow to connect HiBob (Bob) to Unified with OAuth 2.0How to Connect LLMs to Real-Time SaaS Data with Unified.to MCP ServerHow to Connect OpenAI to Real-Time SaaS Data with Unified.to MCP ServerHow to Connect Zoom and Zoom PhoneHow to create a Connection In Microsoft TeamsHow to create a token-based connection in HighlevelHow to Create a Unified.to Connection to HighLevelHow to Create a Xero Connection in Unified.toHow to create and configure webhooksHow to create Connection with HubspotHow to customize portal URLs for Stripe and GoCardlessHow to filter webhook eventsHow-to Get a Private Support Channel for Your Unified IntegrationHow to get help fromHow to get your 8x8 Connect API Key, Account ID and SMS Subaccount ID (optional): Step-by-step guideHow to get your ADP Workforce Now Oauth2 client ID, Oauth2 client secret, Oauth2 PEM certificate and Oauth2 private key: Step-by-step guideHow to get your Amazon S3 AWS Region, AWS S3 Key, AWS S3 Secret and AWS S3 Bucket(s) (optional, comma-separated): Step-by-step guideHow to get your Ashby API Key: Step-by-step guideHow to get your Brex API token: Step-by-step guideHow to get your Bullhorn OAuth2 Client ID, OAuth2 Client Secret, API Username and API Password: Step-by-step guideHow to get your Ceridian Dayforce Username, Password and Client Namespace: Step-by-step guideHow to get your Crelate API key: Step-by-step guideHow to get your Dashlane API Key: Step-by-step guideHow to get your Deel Access Token: Step-by-step guideHow to get your Dialpad API Key: Step-by-step guideHow to get your Discord OAuth 2 credentials and bot tokenHow to get your ELMO client ID and client secret: Step-by-step guideHow to get your Gainsight Client ID, Client Secret and Gainsight API Domain: Step-by-step guideHow to get your Greenhouse API Key and Job board token: Step-by-step guideHow to get your Helpscout API Key: Step-by-step guideHow to get your HiBob Service User ID and Service User Token: Step-by-step guideHow to get your HighLevel API Key and Location ID: Step-by-step guideHow to get your HubSpot developer key and OAuth 2 credentials (Legacy Apps)How to get your Humaans API Key: Step-by-step guideHow to get your iCIMS API Username, API Password and Customer ID: Step-by-step guideHow to get your JobDiva Client ID, Username/email and Password: Step-by-step guideHow to get your Jobvite API Key, API Key Secret and Email: Step-by-step guideHow to get your Lever API Key: Step-by-step guideHow to get your Loxo Agency slug, API Key and Agency ID: Step-by-step guideHow to get your Microsoft Active Directory / Entra ID Client ID, Client Secret and Tenant ID: Step-by-step guideHow to get your Microsoft Azure AD OAuth 2 credentialsHow to get your OAuth 2 credentials for GmailHow to get your OAuth 2 credentials for Microsoft Dynamics 365How to get your OAuth 2 credentials in PipeDriveHow to get your OpenAI API Key: Step-by-step guideHow to get your Paycom SID/Username and Token/Password: Step-by-step guideHow to get your PCRecruiter Username, Password, Database ID, App Key and App ID: Step-by-step guideHow to get your SAP SuccessFactors (OpenID Connect) Username, Password, Client ID, Client Secret, Dependency Name, IAS Host and API URL: Step-by-step guideHow to get your SAP SuccessFactors Username, Company ID, Password and API URL: Step-by-step guideHow to get your Shopify Admin API access token and Store ID: Step-by-step guideHow to get your Wayfair Client ID, Client Secret and Vendor Encrypted Key: Step-by-step guideHow to get your Workable API Token and Subdomain: Step-by-step guideHow to get your yotpo APP Key / Store ID and Secret Key: Step-by-step guideHow to Handle Attachments in Invoice, Bill and Credit MemoHow to Manage Google Ad Manager Orders, Line Items and Creatives with theHow to migrate or import your integrations into Unified.toHow to obtain your GitHub OAuth2 credentialsHow to Power Claude with Live Customer Data Using Unified MCPHow to receive assessment orders from an ATS with Unified.toHow to register a Google developer app and get OAuth 2 credentialsHow to Register a HiBob Developer App and Get OAUTH2 CredentialsHow to register a Salesforce developer app and get OAuth 2 credentialsHow to register a Slack developer account and get OAuth 2 credentialsHow to Register a Workday Developer App and Get OAUTH2 CredentialsHow to Register a ZendeskSell Developer App and Get OAUTH2 CredentialsHow to Register a Zoho Developer App and Get OAUTH2 CredentialsHow to Register an ADP Developer App and Get OAUTH2 CredentialsHow to Register an Atlassian Developer App and Get OAUTH2 CredentialsHow to Register your Facebook OAuth2 ApplicationHow to Register your Google Ads OAuth2 ApplicationHow to Register your MetaAds OAuth2 applicationHow To Request & Write Raw Integration DataHow to Retrieve Microsoft Dynamics 365 Business Central CredentialsHow to set up a custom API URL with a CNAMEHow to Set Up a Google Meet Meeting Bot with UnifiedHow to set up a HiBob marketplace installHow to Set Up a Microsoft Teams Bot with UnifiedHow to Set Up a Microsoft Teams Meeting Bot with UnifiedHow to Set Up a Webex Meeting Bot with UnifiedHow to Set Up a Zoom Meeting Bot with UnifiedHow to set up and configure NotionHow to set up Google Business Profile API access and get OAuth 2 credentialsHow to Set Up LinkedIn Webhooks with UnifiedHow to set up native webhooks for QuickBooks Online with UnifiedHow to set up Slack webhooks using event subscriptionsHow to set up Telegram (bot) with Unified.toHow to set up your scopes in HubSpotHow to setup a Freshbooks developer appHow to setup a TikTok Shop applicationHow to Setup AWS Assume Role for AWS Secret ManagerHow to setup Oracle JD EdwardsHow to Setup Quickbooks DesktopHow to setup Sage 100 with Unified.toHow to test webhooks in the Synthetic Data (Sandbox) environmentHow to troubleshoot unhealthy connectionsHow to troubleshoot unhealthy webhooksHow to Use Decision Models with the Unified GenAI APIHow to use SCIM with the Unified APIHow to use the Passthrough APIHow to Use Unified.to's Generative AI API with OpenAI and ClaudeHow to use User Provisioning and Verification with UnifiedHow virtual webhook retry and recovery worksIntegration set-up guide for LeverManaging custom validation rules in SalesforceNetSuite Authentication Setup for UnifiedNotice of Deprecation of Fields and Objects (Nov 2025)Oracle HCM / Taleo OAuth Credentials GuideRetrieval-Augmented Generation (RAG)SalesForce (External Client Apps) on Multiple OrganizationsSAML Single-Sign-OnScaling MCP Tools with Anthropic's (& OpenAI's) Defer LoadingScaling MCP Tools with Anthropic's Programmatic Tool CallingSet Environments for your Unified.to WorkspaceSetting up a Slack Bot Connection with Unified.toSetting up OAuth 2 Credentials for Greenhouse's APIsTrello Connection Guide in UnifiedUnderstanding OAuth2 Authorization flowsUnderstanding Response Time Headers in the Unified APIUnified Assessment API: Embed Assessments Inside ATS PlatformsUnified's MCP ServerUnified MCP Server with LangChain and LangGraphUnlock real-time data with virtual webhooksUse Unified to sign in your users into your applicationVincere OAuth Setup Guide for UnifiedWhy you can't use Unified's OAuth2 credentials to authorize your end users on ProductionWorkable: Creating candidates and attaching them to jobsWorkday vs Workday Legacy — Why Unified.to Supports BothWorking with hierarchical tree data in Storage, Messaging, and KMS APIs
Are we missing anything? Let us know
Was this page helpful?