Workday Integration Instructions

Note: The Workday integration is currently only available for beta customers. Please speak to your Account Manager for further details before attempting to set up the integration.

Instructions

In order to set up your Workday integration with Hired you are going to need the following credentials:

How to find your Workday Credentials (Tenant and Server Name)

1. We strongly recommend you create an (ISU) Integration System User first, which will give a specific username and password for third-party integrations (like Hired).
2. In addition to username and password, you will also need a tenant and a server name. To get these values, just paste your Workday URL in the below box and click "Get Information".

---

Manually finding your Credentials 

If the above steps do not work, you can manually find your Tenant and Server Name by following these steps.

1. Log in to your Workday Account
2. Search for Public Web Service Services in the search bar
3. Select Any Web Service in the list and click to the contextual menu and go to "Web Service" → "View SDL"  
4. Wait for the page to load and scroll to the bottom. Copy the server name part of the last element in the XML document as shown in the below image and paste it into the Server Name field above. Do the same with the Tenant name.

---

How to create an Integration System User or ISU?

In order to perform the following steps, you must be logged in to your Workday account.

1. Create an Integration System User
   This will be the user that you will use when we ask for the username and password on the credentials form.
   1. Go to the search bar and write 'Create Integration System User'.
      
   2. Click on the task that appears as auto-complete in the dropdown.
      
   3. Fill in the fields for User Name, New Password, and New Password verify. Remember these for later! This username and password will be used to set up the integration.
      
   4. Once you click OK you should see something like this, click Done.
      
      
2. Create a Security Group
   This will be what constrains what the ISU will be able to perform, we will limit it to mostly read permissions, just for candidates we will allow posts of information.
   1. Go to the search bar and write 'Create Security Group'
   2. Click on the task that appears as auto-complete in the dropdown.
      
   3. On the Type of Tenanted Security Group dropdown select 'Integration System Security Group (Unconstrained)', and add a name for the group.
      
   4. Once you click OK you should see something like this:
      
   5. Add the Integration System User that we created in step 1, to link it with the permissions of the group, and then click OK.
      
   6. Then, just click OK and you will see something like the image below. Click Done.
      
      
3. Assign Permissions to the Security Group
   We will add the endpoints we want the ISU to access.
   1. Go to the search bar and write 'View Security For Securable Item'
   2. Click on the Report that appears as auto-complete in the dropdown.
      
   3. After that, you will see this:
      
   4. Write 'Job Postings', and click OK
      
   5. Then you will see the following:
      
   6. Click on the 'Get Job Postings' menu
      
   7. Click on 'View Security' as the image shows
      
   8. You will see the following:
      
   9. For each element in the table: Job Postings Internal and Job Postings External, you will need to access the menu and click over 'Edit Permissions'
      

      1. You will see something like the images below, and on the Integration permissions table, click the + you see there
         

      2. Look for the group we previously created
         
         
      3. Click the Get box also in order to give read permissions, then click OK, followed by clicking Done
         
         
         
   10. Repeat steps 3.1, 3.2, and 3.4 but now instead of 'Job Postings' write 'Job Requitisitons'
   11. Click on 'Get Job Requisitions (Web Service) (Web Service Task)' as in Step 3.7
   12. Then for the only element in the table 'Job Requisition Data' follow steps 3.9, 3.9.1, 3.9.2, and 3.9.3
   13. Repeat steps 3.1, 3.2, and 3.4 but now instead of 'Job Postings' write 'Interviews'
   14. Click on 'Get Interviews (Web Service) (Web Service Task)' as in Step 3.7
   15. Then for the only element in the table 'Candidate Data: Interview Schedule' follow steps 3.9, 3.9.1, 3.9.2, and 3.9.3
   16. Repeat steps 3.1, 3.2, and 3.4 but now instead of 'Job Postings' write 'Candidates'
   17. Click on 'Get Candidates (Web Service) (Web Service Task)' as in Step 3.7
   18. Then for each element in the table 'Prospects' and 'Candidate Data: Job Application' follow steps 3.9, 3.9.1, 3.9.2, and for this, we will check the Get and Put boxes like the image, finally just click OK and then click Done.
       
   19. On the search bar write 'Activate Pending Security Policy Changes', just click the task, add a comment and click OK
       
   20. Finally, you are able to use the new credentials for your Workday Integration!! Use the user name and password you just created for the ISU along with the URL for your Workday instance and paste them into the credentials fields above.