Workday Integration: FAQs, Common Issues & Best Practices

June 18, 2026 17:28

For clients using the Workday Marketplace integration

Version 1.0 · May 2026

1. Common Issues & Resolutions

The table below covers the most frequently reported issues with the Workday Marketplace integration. Match your symptom or error message to find the resolution.

Issue / Symptom	Likely Cause	What to Check / Fix
Assessments not being sent to candidates	Authentication strategy misconfigured, or Reference ID mismatch	All workflows Confirm the authentication strategy in the Harver vacancy settings is set to ATS First or ATS Only. Inline workflow The assessment must be selected in the Inline Assessment Test field on the requisition. Only one assessment should be selected. Ad-Hoc workflow The assessment must be selected in the Default Assessment Tests field on the requisition. Check that the Reference ID prefix in Harver matches the Workflow Step ID in Workday exactly. Example: if the Reference ID is HARVER_P1_<vacancyId>, the Workflow Step ID must be HARVER_P1. Multiphase Additional assessments must also be selected in the Default Assessment Tests field.
Assessment results not being sent back to Workday	Assessment Test Reference ID mismatch, or ISU credentials expired or changed	Assessment Test Reference ID mismatch Confirm the Reference ID on the Harver assessment test in Workday matches the Vacancy ID provided by Harver exactly. For Ad-Hoc: confirm the prefix (e.g. HARVER_P1) matches the corresponding Workflow Step Reference ID. Reference IDs are case-sensitive and cannot be reused across tenants. Reference ID mismatch Go to Workday > Maintain Recruiting Assessment Tests > find the relevant assessment > Related Actions > Integration IDs > Edit Reference ID. Cross-check the Reference ID Value against what Harver has on file for that vacancy. If the Workflow Step Reference ID was edited after the day it was created, confirm it still matches the assessment test prefix. ISU credentials expired or changed Go to the Harver integration credentials section (Harver to ATS tab) and verify the Username and Password match the current ISU credentials in Workday. Confirm ISU_Harver is still listed under System Users Exempt from Password Expiration in Workday's Maintain Password Rules task. If the password was recently updated in Workday, update it in Harver immediately. Confirm the ISU is still an active member of the correct security group (e.g. ISSG_Harver).
ISU sync failures / credentials not working	ISU credentials invalid, expired, or permissions incomplete	Check that the ISU credentials are valid and have not expired. Verify that all required domain security policies are enabled and active for the ISU. Confirm the API Base URL does not include a version number at the end.
Candidate not redirected back to Workday after completing assessment	End page not configured correctly in Harver (Inline flow only)	For Inline flow, the Link to External Website setting on the Harver vacancy End Page must be set to ATS Redirect. Without this, the assessment will appear incomplete even if the candidate has finished it.
Candidate completed Harver but results not showing in Workday	Candidate did not complete the final step in Workday	The candidate must click the button on the Harver End Page to be redirected back to their application in Workday. Once back in Workday, they must click Submit to finalise their application. If they skipped this step, ask them to log back into Workday — their application will be saved as a draft and they can complete it from there.
Candidate sees a Session Timeout error after completing assessment	Workday's 2-hour session limit was exceeded (Inline flow only)	Workday requires the candidate's session to be active when they return from Harver. If the assessment takes longer than 2 hours, the session will expire. The assessment results are not lost. What to tell the candidate: Ask them to refresh the Workday page and log back in with the same credentials. All application fields will be pre-filled. The Take Assessment button may be greyed out — they should click Save and Continue to finalise the application. Results will still appear in Workday successfully.

2. Frequently Asked Questions

Question	Answer
How does the Inline workflow work?	Inline (ATS First Inline) The candidate applies directly within Workday and is redirected to complete the Harver assessment as part of their application. Once finished, they are returned to Workday via a configured return URL, and Harver writes the assessment status and results back to the candidate's Workday profile in real time.
How does the Ad-Hoc workflow work?	Ad-Hoc (ATS First Ad-Hoc) Rather than triggering in real time, Harver polls Workday on a schedule to identify candidates who have been moved to an assessment step but have not yet been invited. When it finds them, it pulls the candidate and application data from Workday and sends the candidate an email invitation to complete the assessment. If using Post-Apply, the candidate will see a task in their Candidate Home in Workday. After completing Harver, they are redirected back to the Candidate Home and the task is marked as Completed. Once the candidate finishes, Harver writes the results back to Workday, updating their profile with status, score, fit label, and any configured indicators.
What happens if you move a candidate to the assessment step straight after creating the requisition?	After creating a new requisition, please wait at least 15 minutes before posting it or moving candidates to an assessment step. A background sync process needs to run first — acting too early may result in candidates being missed by the poll.
Does the Harver integration use Workday Studio?	No — the Harver Workday Marketplace integration does not use Workday Studio.
A new vacancy needs to be added. What's required?	No development work is needed on the Harver side. Harver will provide the Vacancy ID. You then create a new Assessment Test in Workday and update the Reference ID using that ID.
Can assessments be resent to candidates?	Yes, if the results did not reach Workday. Important: resending will overwrite previous statuses. Note: if a candidate has more than one application for the same vacancy, only the first application will be submitted. Support for multiple applications is not yet available.
What happens if the same candidate applies to the same vacancy with a different Requisition ID?	This depends on the reapply setting configured on the vacancy in Harver. If reapply is restricted to a set period (e.g. 6 months), the existing assessment results are automatically sent to Workday. If reapply is set to allow candidates to apply immediately, the candidate will need to retake the Harver assessment.
Can multiple assessments be sent throughout the process (multiphase)?	Yes — multiphase is supported for Ad-Hoc only, or a combination of Inline and Ad-Hoc. Each workflow step must have a unique Reference ID that matches the prefix of its corresponding assessment test. For Post-Apply Ad-Hoc: a candidate must complete their current assessment task before the recruiter can initiate the next one.
Are Evergreen Requisitions supported?	Yes. The assessment must be selected in the appropriate field on the requisition depending on the flow (Inline Assessment Test or Default Assessment Tests). The ISU must have Get access to the following domain policies: Manage Evergreen Requisition — Evergreen Reporting, and Manage Evergreen Requisition — Link Evergreen and Job Requisition.
Are internal candidates supported?	Yes, with some limitations. When enabled, Harver will prioritise sending the assessment invite to the candidate's work email address rather than their personal email. This feature is only supported for the Email Invite Ad-Hoc flow — it is not available for Inline. Workers must have a candidate profile in Workday for this to work. Note: returning employees (former workers) are not supported — the invite would go to their former, likely deactivated, work email address.
What assessment data is sent back to Workday?	Harver sends the following to the Screening section of the candidate's profile in Workday: — Overall Status (In Progress / Completed) — Score (overall numeric matching score) — Matching Label (e.g. Great Fit, Good Fit, Poor Fit) — Comment (key matching indicator names, labels, and fraud details) — Reports URL (link to the full candidate report in Harver) — Inline Assessment flag — Yes (Inline flow only)
What is the Workday session timeout limit?	For the Inline flow, Workday requires the candidate's session to be active when they return from Harver. The default session timeout is 120 minutes. If a candidate takes longer than this to complete the assessment, they will see a session timeout error on redirect. See the Common Issues section above for what to do if this happens.
How do we test the integration end to end?	Inline Apply to a test job via the Workday careers portal, complete the Harver assessment, and confirm you are redirected back to Workday. Check that the candidate's profile in Workday shows the correct status, score, and fit label. Ad-Hoc (Email Invite) Move a test candidate to the assessment step in Workday, wait for the poller to run, and confirm the invite email is received. Complete the assessment and verify the results write back to Workday correctly. Post-Apply Ad-Hoc Move a test candidate to the assessment step in Workday, wait for the poller to run, and confirm the task appears in the Candidate Home. Complete the assessment, confirm the candidate is redirected back to the Candidate Home and the task is marked as Completed. Verify the results write back to Workday correctly.
What is the Harver endpoint URL?	https://integrations.harver.com/orchestrator/v1/flows/startAssessment/workdayinline?accountId=<accountId> Note: this endpoint is only used for the Inline workflow. The accountId parameter is case-sensitive.
What is the Base URL format required in Harver?	Example format: https://impl-services1.wd12.myworkday.com/ccx/service/<tenant>/Recruiting/${apiVersion} Replace <tenant> with your Workday tenant name. Do not append a version number directly to the URL.

3. Best Practices

Following these practices during setup and ongoing use will help prevent most common issues before they arise.

Credentials & Authentication

Exempt the ISU from password expiration: Add ISU_Harver to the System Users Exempt from Password Expiration field in Workday's Maintain Password Rules task. This prevents silent authentication failures caused by expired credentials.
Keep credentials in sync: If the ISU password is updated in Workday, update it in Harver immediately. Stale credentials cause integration-wide failures.
Run Activate Pending Security Policy Changes: Any time you modify ISU security permissions in Workday, this task must be run — changes will not take effect until it is.

Assessment Statuses

Do not mix Overall Status and Test Status checkboxes: Overall statuses (In Progress, Completed) require the Overall Status checkbox. Fit labels (Great Fit, Good Fit, Poor Fit) require the Test Status checkbox. Selecting the wrong one will cause statuses not to appear in Workday.
Status Reference IDs must match exactly: These are case-sensitive and must match what Harver sends. Your Harver Integration Specialist will confirm the correct values.

Candidate Flows

For Inline flow, configure the End Page correctly: The Link to External Website on the Harver vacancy End Page must be set to ATS Redirect before go-live. Without this, candidates will not be redirected back to Workday after completing the assessment.
For multiphase: A candidate must complete their current assessment task before the recruiter initiates the next one. Moving a candidate out of order will mark the new task as Not Started.
Wait 15 minutes after creating a requisition before posting it: A background sync needs to run first to ensure candidates are picked up correctly.
When adding a new workflow step: Wait until the following day before editing its Reference ID in Workday.

Testing

Test in your sandbox or preview tenant before going live Validate your configuration in your Workday preview or sandbox tenant before moving to production. Use the test Vacancy IDs provided by your Harver Integration Specialist — these are sandbox-specific and cannot be reused in production.
Watch out for real candidate data in sandbox Sandbox tenants are often refreshed from production and may contain real candidates. If Harver is connected and those candidates are on active requisitions, it can trigger real assessment invites going out. Before testing, confirm with your Workday admin whether the sandbox contains live data and scope your tests to dedicated test requisitions only.
Sandbox vs production — update everything when you switch Test and production environments use different Vacancy IDs, ISU credentials, Assessment Test Reference IDs, and endpoint URLs. Run through the full configuration checklist again when moving to production — do not assume sandbox settings carry over.
Validate the full candidate journey Test every flow you intend to use end to end. For Inline, confirm the candidate is redirected back to Workday correctly. For Ad-Hoc, confirm the invite email is received and results write back.
Check all result fields After each test submission, confirm the Screening section in Workday shows the correct Recommendation, Score, Matching Label, and a working Results URL.

4. Need More Help?

If an issue cannot be resolved using this guide, please contact your Harver Integration Specialist or the Harver support team.

Contact Harver Support
Email: support@harver.com

When contacting support, please include:

The error message or symptom you are seeing
The date and time the issue occurred
The Workday integration event server log file (from Consolidated Report and Logs)
The candidate name or application ID, if applicable

In this article: