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

# Sage HR

> Connect Sage HR to Iru Compliance with an API key in the X-Auth-Token header and your account subdomain to collect employee, leave, and team directory evidence.

### About Sage HR

Iru calls **`https://YOUR_SUBDOMAIN.sage.hr/api`** with:

```http theme={null}
X-Auth-Token: YOUR_API_KEY
```

Keys are **per admin** and inherit that user’s permissions. Disabling and re-enabling API access **rotates** the key.

### How It Works

Sage HR’s REST API accepts an **API key** in the **`X-Auth-Token`** header. The connector wizard collects your **subdomain** first (to build **`https://{subdomain}.sage.hr/api`**) and the **API key** in a follow-up step.

| Detail             | Value                    |
| ------------------ | ------------------------ |
| **Category**       | HRIS                     |
| **Authentication** | API key (`X-Auth-Token`) |

Official references: [How the API works](https://support.sage.hr/en/articles/3246469-how-does-sage-hr-api-work), [Sage developer HR](https://developer.sage.com/hr/reference/).

### Prerequisites

* **Admin** access.
* **Subdomain** (`acme` from `https://acme.sage.hr`).

### Connect Sage HR to Iru

<Tabs>
  <Tab title="Sage HR">
    <Note>
      Complete this tab before you connect the source in Compliance.
    </Note>

    <Steps>
      <Step title="Sign in to Sage HR">
        Open your Sage HR site (`https://YOUR_SUBDOMAIN.sage.hr`) and sign in with an **Admin** who can change **Integrations** settings.
      </Step>

      <Step title="Open your profile menu">
        Select **Name** (your profile) in the Sage HR header to open the account menu.
      </Step>

      <Step title="Open Settings">
        Choose **Settings** (or **Company settings**, depending on Sage HR edition).
      </Step>

      <Step title="Open Integrations and API">
        Navigate to **Integrations**, then **API** (labels may read **Integrations** → **API access**).
      </Step>

      <Step title="Enable API Access">
        Toggle or select **Enable API Access** and confirm any prompts Sage HR shows about data access.
      </Step>

      <Step title="Copy the API key">
        Copy the **API key** Sage HR displays and store it securely. You will use it as the **`X-Auth-Token`** value in Iru.
      </Step>
    </Steps>

    <Note>
      Continue on the [**Iru Compliance**](#iru-compliance) tab.
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      Finish the [**Sage HR**](#sage-hr) tab first.
    </Note>

    <Steps>
      <Step title="Open Sources">
        In Iru Compliance, on the left navigation bar, expand **Compliance** and select **Sources**.

        <Frame>
          <img src="https://mintcdn.com/iru/7HsGH7lnQ8GpVmI0/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=7HsGH7lnQ8GpVmI0&q=85&s=595982441fd777b333b3ecfea24adc24" alt="Left navigation: Compliance expanded, Sources selected" width="424" height="1056" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Turn on Sage HR">
        Find **Sage HR** (use **Category** or **Search by name or description**). On that card, turn on the **toggle**. A browser tab or window may open for the connector wizard.
      </Step>

      <Step title="Enter subdomain">
        Enter **subdomain** when the wizard asks for it.
      </Step>

      <Step title="Paste the API key header value">
        Paste the **`X-Auth-Token`** value when prompted.
      </Step>

      <Step title="Finish the connection">
        Click **Submit API Key**. When the connection succeeds, the wizard shows **Connection Configured**.
      </Step>

      <Step title="Confirm the source is Active">
        Close the **Iru is requesting access to external services** browser tab, then return to **Compliance** → **Sources** and confirm the **Sage HR** card is **Active**.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Troubleshooting

<AccordionGroup>
  <Accordion title="Nothing opens when you turn the source on">
    Check **pop-up blocker** settings for the Iru site and try again.
  </Accordion>

  <Accordion title="401 Unauthorized">
    Key rotated - recopy after re-enable.
  </Accordion>

  <Accordion title="Wrong tenant">
    Correct **subdomain**.
  </Accordion>
</AccordionGroup>

### Related Articles

<CardGroup cols={2}>
  <Card title="Sources Management" icon="plug" href="/en/compliance/sources-management">
    Browse and manage every Compliance source.
  </Card>

  <Card title="Getting Started With Compliance" icon="rocket" href="/en/compliance/getting-started-with-compliance">
    Frameworks, actions, and **Artifacts**.
  </Card>

  <Card title="Iru Overview" icon="layer-group" href="/en/iru/platform-overview/iru-overview">
    How Endpoint, Compliance, and Identity fit together.
  </Card>

  <Card title="Artifacts Management" icon="folder-open" href="/en/compliance/artifacts-management">
    Upload, review, and organize evidence from sources and actions.
  </Card>
</CardGroup>