This guidance assumes that you have admin privileges for your Workday account.

Create an Integration System from StackOne

1

Create a Webhook

Set up a webhook in StackOne

Please make sure that the webhook in the grid below is set to enabled

2

Add a webhook event

To add or modify a webhook event, click the Edit event button and then select the + button next to created under ATS Assessments.

When the pop-up appears, please select the Invited event under Workday and click the Confirm button.

Please remember to click on the Save button.

Once you have completed the steps above, the StackOne_IS_System Integration System has been successfully created in your linked Workday account.
3

Verify the integration on the Workday

Log into your Workday account and search for StackOne_IS_System

4

Updated Endpoint Url

You can find the Endpoint URL under integration system attributes on the StackOne_IS_System page. This URL is used by StackOne to receive notifications about Assessment Invites.

Create Assessment Category in Workday

1

Create an assessment category

Navigate to the Maintain Recruiting Assessment Categories page and add a new assessment category called Technical Assessment Test.

Please click on the OK button to save and the Done button to confirm.

Create Assessment Test in Workday

1

Create an assessment test

Navigate to the Maintain Recruiting Assessment Tests page and add an assessment test called Technical Assessment.

Enter the test name, select the assessment category created in the previous step, and choose the integration system generated from StackOne, named StackOne_IS_System.

Please click on the OK button to save and the Done button to confirm.

2

To edit or retrieve the Assessment Test ID

Click on the three-dot menu, go to View IDs to see and click on Edit Reference ID to make changes to the Reference ID.

3

Use of Assessment Test ID

You’ll need the Assessment_Test_ID which is RECRUITING_ASSESSMENT_TEST-6-111 here for notification payload configurations.

Create Assessment Status in Workday

1

Create an assessment status

Navigate to the Maintain Assessment Statuses page and add a new assessment status called Invited.

Enter the status name, check the overall status and test status. Click on OK and Done buttons to save and confirm, respectively.

2

To edit or retrieve the Assessment Status ID

Click on the three-dot menu, go to View IDs to see and click on Edit Reference ID to modify the Reference ID.

3

Use of Assessment Status ID

You will need to use the Assessment_Status_ID, which is Invited, when submitting the assessment to the candidate.

Update Assess Candidate Business Process in Workday

1

Select to update the Integration System

Navigate to the Assess Candidate Business Process page. Then, click on the Configure StackOne_IS_System button.

Please select StackOne_IS_System as the integration and then click on the OK button.

2

Edit payload attribute values

The pop-up will appear, allowing you to select the values for the fields included in the payload request when the Invited event is triggered from Workday.

Please fill in the following information:

  • Candidate First Name: [First Name]
  • Candidate Last Name: [Last Name]
  • Candidate Email Address: [Email]
  • Candidate Reference ID: [Candidate ID]
  • Job Application Reference ID: [Job Requisition as Text]
  • Assessment Test Reference ID: [Assessment_Test_ID for the assessment you want to send to the candidate]

Click the OK button to save your configurations.

Job requisitions within the supervisory organization in Workday

These steps assume you already have a Supervisory Organization in your Workday account. If not, please contact your admin to create one.

1

Listed Job Requisitions

Navigate to yourSupervisory Organization page. Go to the Staffing tab below.

You can find the list of Job Requisitions that the Assessment stage supports for sending notifications within the Integration System. New Job Requisitions can be added here.

Submit your application for the job from the candidate’s profile in Workday

1

Apply to the Job

Go to the Find Candidates page, select a Candidate’s Profile, and click on Job Application under Actions to apply for the job.

2

Select the listed Job Requisition

Please select the job from the dropdown menu listed above.

Enter the required details and click the OK button to submit the job application.

Move Candidate to the Assessment Stage in Workday

1

Go to the Job Requisition

Navigate to the Job Requisitions page by selecting the same Job Requisition from the pop-up where the candidate applied for the job.

Navigate to the Candidate tab and select the Review tab, where the candidate will be displayed in the grid below.

2

Move Candidate from Review to Assessment stage

Check the candidate in the grid and click the Move Forward button.

3

Select Assessment from the dropdown

In the pop-up, select the next stage, which is likely the Assessment Stage. Choose Assessment in both dropdown menus.

Click on the OK button to move.

4

Candidate Moved to the Assessment Stage

If you go to the Assessment tab, the candidate will now be in the Assessment stage.

If you’re unable to move the candidate to the assessment stage directly, then shift the stages one at a time.

Send the assessment invitation to the candidate using Start Proxy.

1

Sending via Start Proxy

If you are not the recruiter, go to the recruiter’s account via Start Proxy. Click on the Awaiting Action link, and a pop-up will appear showing the recruiter’s name.

2

Navigate to the Start Proxy

Go to the Start Proxy page and select Recruiter from the dropdown menu.

You’ll be taken to the recruiter’s homepage, where you need to navigate to the My Tasks page in the top-right corner.

You will find the task at the top labeled with Job Requisition and Candidate name in the sidebar.

Clicking on the sidebar task will display the candidate’s assessment details on the right side.

3

Send the Assessment Invitation

You should set the Overall Status to Invited and select the Assessment as Technical Assessment from the dropdown menu. After that, click the Submit button.

Send the assessment invitation to the candidate without using a start proxy

1

Sending via Start Proxy

If you are the recruiter, you should see the Assess button next to the candidate’s name.

2

Send the Assessment Invitation

You should set the Overall Status to Invited and select the Assessment as Technical Assessment from the dropdown menu. After that, click the Submit button.

Received webhook notification

1

Received notification payload

You will receive a webhook notification at your specified endpoint URL on StackOne. Here is an example of the payload.

Check out the following link for all the details about webhooks!

Update the result in Workday.

1

Request to update result

Use record_id as the order id in the Update Assessment endpoint with the required body payload:

  {
    "score": {
      "value": "906"
    },
    "assessment_date": "2024-08-11T00:00:00.000Z",
    "submission_date": "2024-08-12T00:00:00.000Z",
    "summary": "Assessment is Passed",
    "result": {
      "value": "passed"
    },
    "result_url": "https://www.example.com/content/assessment-result.pdf"
  }

Check out the following link for all the details about update assessment result!

2

Updated result in Workday

If you received a successful response, you can verify the score in Workday, which should be visible in the task list next to the assessment name.


Congratulations, you’re all set! If you face any issues with the steps mentioned above, please contact us by emailing integrations@stackone.com. We’re always here to assist you!