Workday
Username, password and API Url are needed to integrate with Workday.
Last updated
Username, password and API Url are needed to integrate with Workday.
Last updated
Adway requires clients to authenticate in order to receive access to the customers open jobs feed. There are two types of authentication that Adway supports: 1) Customer credentials (SOAP API based) 2) OAuth 2.0 (REST API based, Preferred way) Both apporaches are outlined below:
To integrate with Workday, clients need to provide their Customer Success Manager (CSM) at Adway with the following:
Username, Password, and API URL: You must provide a username and password for an account that has access to your Workday SOAP API, along with the specific SOAP API URL through which we can interact with your Workday system.
Example SOAP API URL:
https://services1.myworkday.com/ccx/service/CUSTOMER_SLUG/Recruiting/v42.2
(This is just an example. Please provide your specific API URL.)
Required Permissions: The account you provide must have both read and write permissions for the following resources:
Recruiter Resource
Human_Resources Resource
Source ID: We recommend designating Adway as a source in Workday and sharing the Source ID with us. This will help us differentiate Adway-submitted applications from other sources.
Communication Method: Adway uses SOAP (Simple Object Access Protocol) to communicate with the Workday API. All requests are sent as XML messages, included in the body of the request. For this communication to work, the client must provide us with the appropriate account credentials (username/password) and the SOAP API URL.
Permissions and Resources: The account created should have access to both the Recruiter Resource and the Human_Resources Resource. These resources need to allow the following operations:
:
(READ)
(WRITE)
:
(READ)
(READ)
Example SOAP API URL:
While each client’s URL may differ, here’s an example of a typical SOAP URL format:
https://services1.myworkday.com/ccx/service/CUSTOMER_SLUG/Recruiting/v42.2
Source Designation: It’s beneficial to set up Adway as a source within your Workday system. Doing so will allow us to tag and identify applications coming through Adway more easily. Sharing the Source ID with us will streamline this process. How to get a Public SOAP API URL: 1) Go to the Workday admin panel, type "Public Web Services" in a search field: 2) Hover over necessary service (in our case Recruiting, however, this is not mandatory to be only Recruiting). Open menu (3 dots), choose Web service - View WSDL
3.1. On Adway platform, navigate to the Connectors screen. From there create a connector (by clicking a plus icon), as a System choose “Workday”, choose API (OAuth) as a routine.
3.2. Integration setup and enablement in the Workday platform. Navigate to your Workday Dashboard. Configuring new API Client (From inside Workday search for the “Register API Client” function)
Choose “Authorization Code Grant”:
Provide access to the following scopes: Staffing, Recruiting, Tenant Non-Configurable
Click “Save”. The following 5 fields are going to be displayed after successful saving: a. Client ID b. Client Secret c. Workday REST API Endpoint d. Token Endpoint e. Authorization Endpoint
3.3. Copy all the displayed values in the previous step and insert them into the corresponding fields from under the Adway connector setup:
Save your connector and click Authorize. This will bring a similar to Google OAuth dialog window with promt to login into Workday:
Once logged in, user will be redirected back to Adway with the connection successfully established.
3) XML file will be opened, scroll down to the very bottom of the page and locate the URL:
Insert the following link into Redirect URL field:
