Workday ATS E2E Assessment
To successfully set up a webhook for a Workday Assessment, follow these steps to understand the end-to-end process and configurations, including the necessary actions for webhook notification.
This guidance assumes that you have admin privileges for your Workday account.
Create an Integration System from StackOne
Create a Webhook
Set up a webhook in StackOne
Please make sure that the webhook in the grid below is set to enabled
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.
StackOne_IS_System
Integration System has been successfully created in your linked Workday account.Verify the integration on the Workday
Log into your Workday account and search for StackOne_IS_System
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
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
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.
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.
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
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.
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.
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
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.
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.
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
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.
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
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.
Move Candidate from Review to Assessment stage
Check the candidate in the grid and click the Move Forward
button.
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.
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.
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.
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.
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
Sending via Start Proxy
If you are the recruiter, you should see the Assess
button next to the candidate’s name.
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
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!
StackOne Webhooks
Update the result in Workday.
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!
Update Assessments Result
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!