Skip to content
Contact support Customer portal
  • There are no suggestions because the search field is empty.

Set up a Workday integration

 
Coderbyte integrates with Workday Recruiting to automate technical assessments. When a candidate reaches the Assessment stage, Coderbyte automatically sends them an invitation. Once completed, results — including score, scorecard link, and completion date - are pushed directly into the candidate's Workday profile.
Unlike other ATS integrations, Workday does not support real-time webhooks. Coderbyte polls Workday every few minutes, so assessment invitations are triggered within minutes of the status being set.

To authenticate your Workday account, you will need to provide the following information:

  • WSDL

  • ISU Username

  • ISU Password

  • Workday Tenant Name

Prerequisites

Please ensure you fulfill all the requirements to set up the integration:

  • You have Administrator permissions in your company's Workday instance

  • You have the API add-on enabled in Coderbyte

Step 1: Workday Initial Configuration

 

Create an Integration System User (ISU)

  1. In your Workday portal, log into the Workday tenant

  2. In the Search field, type Create Integration System User

  3. Select the Create Integration System User task
    ​

  4. On the Create Integration System User page, in the Account Information section, enter a user name, and enter and confirm a password
    ​
    ​Important: "&", "<", or ">" characters cannot be included in the password
    ​

  5. Click OK
    ​

  6. To ensure the password doesn't expire, you'll want to add this new user to the list of System Users. To do this, search for the Maintain Password Rules task.
    ​


    Add the ISU to the System Users exempt from password expiration field
    ​

  7. Enter the Integration System User name in the linking flow

  8. Enter the Integration System User password in the linking flow
    ​

 

Create a Security Group and assign an Integration System User

  1. In the Search field, type Create Security Group
    ​


    Select the Create Security Group task.
    ​

  2. On the Create Security Group page, select Integration System Security Group (Unconstrained) from the Type of Tenanted Security Group pull-down menu.
    ​

  3. In the Name field, enter a name

  4. Click OK

  5. On the Edit Integration System Security Group (Unconstrained) page, in the Integration System Users field, enter the same name you entered when creating the ISU in the first section
    ​

  6. Click OK

 

Configure domain security policy permissions

  1. In the Search field, type Maintain Permissions for Security Group
    ​

  2. Make sure the Operation is Maintain, and the Source Security Group is the same as the security group that was assigned in Step 2
    ​

  3. On the next screen, add the corresponding Domain Security Policies depending on your use case:
    ​

 

Activate security policy changes

  1. In the search bar, type "Activate Pending Security Policy Changes" to view a summary of the changes in the security policy that needs to be approved
    ​

  2. Add any relevant comments on the window that pops up

  3. Confirm the changes in order to accept the changes that are being made and hit OK
    ​

 

Validate the authentication policy is sufficient

  1. Search for Manage Authentication Policies
    ​

  2. Click Edit on the authentication policy row
    ​

  3. Create an Authentication Rule
    ​

  4. Enter a name, add the Security Group, and ensure Allowed Authentication Types is set to Specific User Name Password or Any
    ​

Note: You don't have to create a new Authentication Rule if you already have an existing one set to User Name Password or Any. You can add the ISU you created to that rule instead.
​
You will need to create a new rule if SAML is the only Authentication Rule you see for "Allowed Authentication Types."

Activate all pending authentication policy changes

  1. In the search bar type, activate all pending authentication policy changes
    ​

  2. Proceed to the next screen and confirm the changes. This will save the Authentication Policy that was just created or edited

 

Obtain the web services endpoint URL

  1. Search in Workday for Public Web Services
    ​

  2. Find Recruiting if you are connecting Workday ATS.
    ​
    Click the three dots to access the menu. Click Web Services > View WSDL
    ​

  3. Navigate to the bottom of the page that opens (it may take a few seconds to load)

  4. Copy the full URL provided under RecruitingService (Workday ATS). The URL will have a format similar to https://wd5-impl-services1.workday.com/ccx/service/acme/Recruiting/v46.0

 

Configure Workday Assessment statuses

Step 1. Create Assessment Statuses

In Workday, search for Maintain Assessment Statuses and create the following four statuses. For each, set both Overall Status and Test Status, and ensure the Reference ID is set exactly as shown.

Name Reference ID Overall Status Test Status
Coderbyte Send Invite CODERBYTE_SEND_INVITE Yes  
Coderbyte Sent CODERBYTE_SENT Yes Yes
Coderbyte In Progress CODERBYTE_IN_PROGRESS Yes Yes
Coderbyte Complete CODERBYTE_COMPLETE Yes Yes

Step 2. Create an Assessment Test

In Workday, search for Maintain Recruiting Assessment Tests and create one entry:

Name Reference ID
Coderbyte Assessment coderbyte_assessment

This is a single generic entry - the specific test sent to each candidate is configured in your Coderbyte dashboard, not in Workday.

Step 3. Assess Candidate Stage

Ensure your job application business process includes an Assess Candidate step. This is the stage where Coderbyte's integration activates. Most Workday tenants have this step by default — confirm with your Workday admin that it is active for the requisitions you want to use with Coderbyte.

Step 4. Update ISU Permissions

Add the following domain security permissions to the security group used by your Coderbyte ISU:

Domain Permission
Assess Candidate GET + PUT
Candidate Data: Job Application GET + PUT
Candidate Data: Assessment Results GET + PUT

After saving, run Activate Pending Security Policy Changes to apply them.

Connect to Coderbyte

Once the Workday configuration is complete, navigate to Coderbyte dashboard and enter the following credentials in the Workday connection form:

  • Workday SOAP endpoint URL
    Example: https://wd5-impl-services1.workday.com/ccx/service/your-tenant/Recruiting/v46.0
  • ISU username (in username@tenant format)
  • ISU password

Coderbyte will complete the connection and confirm when the integration is active.