> ## Documentation Index
> Fetch the complete documentation index at: https://docs.heymilo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Workday

> Integrating HeyMilo with Workday unlocks seamless end-to-end AI candidate screening directly inside your hiring workflow, from automated interview invites to instant write-backs of reports, scores, transcripts, and insights into Workday candidate records.

## **Prerequisites**

Before you start, make sure you have:

* Workday integration system user (ISU) credentials with permission to read jobs, candidates, and applications, and to write notes/attachments back to candidate records.
* Workday admin access to add HeyMilo as an Assessment Vendor in your tenant (your Workday admin will be prompted during the OAuth flow).
* HeyMilo workspace owner or admin role to enable integrations.

## **Enable The Integration**

<video src="https://storage.googleapis.com/heymilo-pub-docs/videos/Workday%20(1).mp4" controls />

You only need to do this once per workspace. After this, every req you want to use HeyMilo on just needs to be linked to a HeyMilo agent (covered in the next section).

<Steps>
  <Step title="Open Integrations in HeyMilo From your HeyMilo dashboard, open the Integrations page from the left side panel." />

  <Step title="Find Workday under Available Integrations Scroll down to Available Integrations and click on Workday.">
    <Frame>
      <img src="https://mintcdn.com/heymilo/0zaDzk1xSL6YIdaM/images/Screenshot-2026-04-29-at-7.32.24-PM.png?fit=max&auto=format&n=0zaDzk1xSL6YIdaM&q=85&s=37a1820dd8fdda4986c627359887c164" alt="Screenshot 2026 04 29 At 7 32 24 PM" width="2586" height="1052" data-path="images/Screenshot-2026-04-29-at-7.32.24-PM.png" />
    </Frame>
  </Step>

  <Step title="Connect Workday On the Workday integration page, click Connect Now. A secure Workday connection window will open.">
    <Frame>
      <img src="https://mintcdn.com/heymilo/0zaDzk1xSL6YIdaM/images/Screenshot-2026-04-29-at-7.33.00-PM.png?fit=max&auto=format&n=0zaDzk1xSL6YIdaM&q=85&s=6eb52b1cf2778e0783204c7f220ea97d" alt="Screenshot 2026 04 29 At 7 33 00 PM" width="1616" height="1442" data-path="images/Screenshot-2026-04-29-at-7.33.00-PM.png" />
    </Frame>

    * Approve HeyMilo's requested permissions (read access to jobs, candidates, and applications; write access for notes, attachments, and stage updates).
    * Go through the steps as prompted.
    * Confirm to complete the connection.
  </Step>

  <Step title="Confirm Workday is connected Once the connection completes, you'll see a 'Workday Integration Active' status in HeyMilo.">
    <Frame>
      <img src="https://mintcdn.com/heymilo/0zaDzk1xSL6YIdaM/images/Screenshot-2026-05-12-at-11.33.17-AM.png?fit=max&auto=format&n=0zaDzk1xSL6YIdaM&q=85&s=b90fc970f7053db940e01f4f26158bae" alt="Screenshot 2026 05 12 At 11 33 17 AM" width="2880" height="1548" data-path="images/Screenshot-2026-05-12-at-11.33.17-AM.png" />
    </Frame>
  </Step>
</Steps>

## Use the Integration With Workday

Once the integration is enabled, the only setup remaining is linking each Workday requisition to the HeyMilo agent that should screen for it. After that, everything for that role happens in Workday.

<Steps>
  <Step title="Link a Workday requisition to a HeyMilo agent In HeyMilo, open the agent you want to use for this role (for example, Customer Service), and go to its ATS Configuration section.">
    * Select Workday from the integration dropdown.
    * Pick the Workday requisition you want to link from the list of jobs.
    * Save the mapping.

    This is a one-time step per requisition — once it's saved, every candidate who reaches the HeyMilo assessment stage on this Workday req will automatically be screened by this agent.

    <Frame>
      <img src="https://mintcdn.com/heymilo/0zaDzk1xSL6YIdaM/images/Screenshot-2026-04-29-at-7.38.00-PM.png?fit=max&auto=format&n=0zaDzk1xSL6YIdaM&q=85&s=f3bc1afe3363611a78e86f62d1adf3d7" alt="Screenshot 2026 04 29 At 7 38 00 PM" width="2244" height="1124" data-path="images/Screenshot-2026-04-29-at-7.38.00-PM.png" />
    </Frame>
  </Step>

  <Step title="Move a candidate to the HeyMilo assessment stage in Workday From here on, your recruiters work entirely in Workday. When a candidate is ready to be screened, move them from Review into the Assessment stage that triggers HeyMilo." />

  <Step title="HeyMilo automatically invites the candidate The stage move triggers HeyMilo to send the candidate the screening invite by email and/or SMS — no recruiter action needed.">
    * The candidate clicks the link and completes the AI screening flow.
    * Recruiters can monitor progress in Workday; HeyMilo updates the candidate record as the screening progresses.
  </Step>

  <Step title="Results write back to Workday When the candidate finishes the interview, HeyMilo automatically writes the results back to the candidate's Workday profile, including:">
    * A note on the candidate with their HeyMilo pdf report in attachments and additional data
          <Frame>
            <img src="https://mintcdn.com/heymilo/0zaDzk1xSL6YIdaM/images/Screenshot-2026-05-12-at-11.26.50-AM.png?fit=max&auto=format&n=0zaDzk1xSL6YIdaM&q=85&s=acae6169aa12f2fb8a9a38b58f8e3eb7" alt="Screenshot 2026 05 12 At 11 26 50 AM" width="2842" height="1574" data-path="images/Screenshot-2026-05-12-at-11.26.50-AM.png" />
          </Frame>
  </Step>

  <Step title="View the full report Clicking the View Report link in attachments from the Workday candidate record opens the detailed HeyMilo screening summary — transcript, score breakdown, qualifier responses, and AI-generated insights.">
    <Frame>
      <img src="https://mintcdn.com/heymilo/0zaDzk1xSL6YIdaM/images/Screenshot-2026-05-12-at-11.27.07-AM.png?fit=max&auto=format&n=0zaDzk1xSL6YIdaM&q=85&s=8046f6447dde9cc186d664f66ad143f8" alt="Screenshot 2026 05 12 At 11 27 07 AM" width="2948" height="1730" data-path="images/Screenshot-2026-05-12-at-11.27.07-AM.png" />
    </Frame>
  </Step>
</Steps>

## Additional Resources

For additional information not covered here, reach out to [support@heymilo.ai](mailto:support@heymilo.ai).
