Set up a connection to Workday (HTTP) connector

Naga Sri Hari Gonaboyina

Updated May 21, 2025 01:05

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: Get Workers, invoice, budget, customer, and scorecard details SOAP: Get human resource details Workday Adaptive Planning: Get modeling, data integration, and metadata details
API type: REST
Subdomain *	Enter your subdomain of the Workday account environment. For example, if you sign in at `https://wd2-impl-services1.workday.com/ccx/` , 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 subdomain of the Workday account environment. 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 basic auth universal connector documentation.

How to retrieve the client ID and client secret

Sign into 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.