Set up a connection to Workday (HTTP) connector

Naga Sri Hari Gonaboyina

Updated December 05, 2025 06:55

Workday is an enterprise management cloud platform that provides solutions for finance, HR, spend management, and planning.

Important

Celigo provides the following two connectors to connect to Workday:

Workday: This new connector supports primarily SOAP API (via SQL queries) and has more options to better integrate with Workday. Set up a connection to Workday using the new Workday connector.
Workday (HTTP): The previous Workday connector renamed to Workday (HTTP) supports primarily REST API. See the instructions below to set up a connection to Workday using the Workday HTTP connector.

Set up a connection

Required preparation

To set up a connection to Workday, you must first:

Create an Integration System User (ISU) for Celigo in your Workday account. For information on how to create an ISU, see Workday integration.
Add the security domains in the Integration System Security Group (ISSG) for Celigo as shown:

After you start the connection , configure it in the Create connection panel and complete all of the required * authentication settings:

Setting	Instructions
Name your connection *	Enter a clear and distinguishable name. Throughout integrator.io imports and exports, you will have the option to choose this new connection. A unique identifier will prove helpful later when selecting it from a list of the connections in your account.
API type *	Choose your Workday account API type: REST: Modern, lightweight API for accessing worker, organization, and business process data for real-time integrations and mobile-friendly applications. SOAP: Comprehensive web service interface covering nearly all Workday modules for deep integrations that require access to core HR, finance, and payroll data. Workday Adaptive Planning: Interact with planning models, sheets, and metadata and automate data imports/exports and manage financial planning workflows.
API type: REST
Subdomain *	Enter your Workday account environment subdomain. For example, if you sign in at `https://wd2-impl-services1.workday.com/`, your subdomain is `wd2-impl-services1.workday`.
Tenant ID *	Enter your Workday tenant ID. For example, if your Workday tenant URL is `https://impl.workday.com/sample_company/d/home.html`, then `sample_company` is your tenant ID.
OAuth 2.0 client *	Select the OAuth 2.0 client that stores the client ID and client secret provided to you by Workday. How to retrieve the client ID and client secret To add an OAuth 2.0 client and configure your credentials, click the plus (+) button. Click the edit () button to modify a selected OAuth 2.0 client. For more information, see Create an OAuth 2.0 iClient resource
API type: SOAP
Subdomain *	Enter your Workday account environment subdomain. For example, if you sign in at `https://wd2-impl-services1.workday.com/ccx/` , your subdomain is `wd2-impl-services1.workday`.
Version *	Enter your Workday Web Service (WWS) version. For example, `v41.0`.
Tenant ID *	Enter your Workday tenant ID. For example, if your Workday tenant URL is `https://impl.workday.com/sample_company/d/home.html`, then `sample_company` is your tenant ID.
Username *	Enter your ISU username and append `@tenant ID`. For example, if `IN000_Celigo` is your username and `xyz1234` is your tenant ID, then enter `IN000_Celigo@xyz1234`.
Password *	Enter your ISU login password.
API type: Workday Adaptive Planning
Username *	Enter your Workday Adaptive Planning account username.
Password *	Enter your Workday Adaptive Planning account password. Multiple layers of protection, including AES 256 encryption, are in place to keep your password safe. When editing this connection, you must re-enter this value each time; it is stored only when the connection is saved and never displayed as text.

Tip

This connector documentation describes only the settings shown for the Simple view. For the corresponding HTTP settings, see the Basic auth universal connector documentation.

How to retrieve the client ID and client secret

Sign in to your Workday account.
Search and navigate to View API clients > API clients.
Click Register API client.
Enter a Client name.
For the Client grant type, choose Authorization code grant.
For the Access token type, choose Bearer.
Enter integrator.io Redirect URI.
Select OAuth 2.0 scopes.
Click Done.
Copy the Client ID.
For the Client grant type, choose Authorization code grant.
For the Access token type, choose Bearer.