> ## Documentation Index
> Fetch the complete documentation index at: https://iru-kbee-63-enhance-rts-documentation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Workday

> Connect Workday to Iru Identity so it reads workers from a custom report and keeps your Iru directory in sync as people are hired, transferred, or terminated.

Connecting **Workday** lets Iru pull worker records straight from a Workday report
and keep your [directory](/en/identity/directory/directory-overview) in sync: when
someone is hired, changes departments, or leaves, those updates flow into Iru on
their own.

<Note>
  For the Workday-specific steps only. For concepts shared across all sync
  connections (the unique identifier, required fields, IQL, and what happens on
  each sync), see
  [Directory Sync](/en/identity/directory/directory-sync).
</Note>

<Steps>
  <Step title="Choose Workday">
    In **Directory → Sync**, select **Connect Source** and pick **Workday**.
  </Step>

  <Step title="Enter connection details">
    Give the connection a **display name** and an optional **description**. Enter the
    **instance host** and **Workday tenant** so Iru knows which Workday environment
    to call, then continue.
  </Step>

  <Step title="Enter integration credentials">
    Enter the **Integration user** (the Workday Integration System User that runs the
    report) and its **Password**. Iru submits these credentials directly; there is no
    separate Workday consent window. Iru stores the password encrypted and does not
    show it again after you save.

    <Frame caption="Authorizing Iru with the Integration System User credentials.">
      <img src="https://mintcdn.com/iru-kbee-63-enhance-rts-documentation/xPI6Kg4GeZfqxVVE/assets/media/images/iru-identity-connect-workday.png?fit=max&auto=format&n=xPI6Kg4GeZfqxVVE&q=85&s=35753761c3761e3aaf10f2ab8b204d21" alt="The Connect with Workday step asking for Integration user and Password, with helper text that the account should be an Integration System User with access to the report." width="1266" height="267" data-path="assets/media/images/iru-identity-connect-workday.png" />
    </Frame>

    <Tip>
      Use a dedicated Integration System User rather than a personal login, so the
      connection keeps working as users come and go. This is not the report owner.
    </Tip>
  </Step>

  <Step title="Point Iru at your report">
    Enter the **report name** Iru should run.

    Everything Iru imports comes from the columns in that report, so make sure it
    includes every field you care about (email, name, department, manager, employee
    ID, and so on).
  </Step>

  <Step title="Map your data to Iru">
    Iru reads your report's columns and lays them out to match to Iru attributes.

    * **Set a unique identifier:** choose the column that uniquely identifies each
      user, usually an **employee ID**. Once you save the connection, it can't be
      changed.
    * **Map the required attributes:** **email, first name, last name, and username**
      must be mapped; everything else is optional.
    * **Transform with IQL when needed:** pick a column, or write a short IQL
      expression to build a value. Iru suggests your report's column names and checks
      the expression as you type.

    Examples (illustrative; use your report's own column names):

    * Build a username from an email: `email_work.split("@")[0]`
    * Combine two columns: `first_name + " " + last_name`
    * Prefer one column, fall back to another: `optional.ofNonZeroValue(email_work).orValue(email_home)`

    See [Map your data](/en/identity/directory/directory-sync#map-your-data) for more
    on mapping, including the safe pattern for sometimes-blank fields.
  </Step>

  <Step title="Finish and turn it on">
    Save your mappings. You'll land on the connection's detail page; review
    everything, then **Enable**. A connection starts **disabled**, so enabling it kicks
    off the first import and keeps Iru in sync.

    On the detail page you can later **re-authenticate**, **edit your report or
    mappings**, set how often Iru syncs, run **Sync now**, and **review activity,
    effective users, and sync errors**.

    <Frame caption="Re-authenticate submits current Integration System User credentials without changing your mappings.">
      <img src="https://mintcdn.com/iru-kbee-63-enhance-rts-documentation/xPI6Kg4GeZfqxVVE/assets/media/images/iru-identity-reauthenticate-workday.png?fit=max&auto=format&n=xPI6Kg4GeZfqxVVE&q=85&s=6c5e2d1191e9c770e8591ede5f420cdc" alt="The Re-authenticate Workday dialog with Integration user and Password fields." width="893" height="289" data-path="assets/media/images/iru-identity-reauthenticate-workday.png" />
    </Frame>
  </Step>
</Steps>

## Related

<CardGroup cols={2}>
  <Card title="Directory Sync" icon="building-user" href="/en/identity/directory/directory-sync">
    The shared concepts behind every Directory Sync provider.
  </Card>

  <Card title="Connect BambooHR" icon="seedling" href="/en/identity/directory/hris-bamboohr">
    The other supported HR system, simpler and with no report step.
  </Card>
</CardGroup>
