> ## 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.

# Workable

> Connect Workable to Iru Compliance with a scoped Bearer token and your account subdomain to collect job, candidate pipeline, and recruiter access evidence.

### About Workable

Iru calls **`https://YOUR_SUBDOMAIN.workable.com/spi/v3`** with **`Authorization: Bearer`**. Access tokens are **scoped** and carry a **mandatory expiration** (between **30 days** and **2 years**). Use **read** scopes only, e.g. **`r_jobs`**, **`r_candidates`** - and omit **write** scopes for least privilege.

### How It Works

```http theme={null}
Authorization: Bearer YOUR_ACCESS_TOKEN
```

| Detail             | Value                        |
| ------------------ | ---------------------------- |
| **Category**       | ATS / recruiting             |
| **Authentication** | Bearer (scoped access token) |

Official references: [Access tokens](https://help.workable.com/hc/en-us/articles/115015785428), [API](https://help.workable.com/hc/en-us/articles/115013356548), [REST reference](https://workable.readme.io/reference).

### Prerequisites

* **Admin** role - only Admins create tokens.
* **Subdomain** from `https://YOUR_SUBDOMAIN.workable.com`.

### Connect Workable to Iru

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

    <Steps>
      <Step title="Sign in to Workable">
        Open `https://YOUR_SUBDOMAIN.workable.com` and sign in with an **Admin** (only Admins can create access tokens).
      </Step>

      <Step title="Open your profile menu">
        Select **Profile** (or your avatar) in the Workable header.
      </Step>

      <Step title="Open Settings">
        Choose **Settings** from the menu.
      </Step>

      <Step title="Open Integrations">
        Select **Integrations** (or **Developer** / **API**, depending on your Workable edition) until you see **Access Tokens**.
      </Step>

      <Step title="Generate a new token">
        Open **Access Tokens**, then **Generate new token**. Enter a name such as **Iru Compliance**.
      </Step>

      <Step title="Set expiry and read scopes">
        Set **expiry** per your rotation policy. Enable only **read** scopes your controls need (for example **`r_jobs`**, **`r_candidates`**).
      </Step>

      <Step title="Generate and copy the token">
        Generate the token and copy the value **once** when Workable displays it. Store it securely until you paste it into Iru as the **Bearer** token.
      </Step>
    </Steps>

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

  <Tab title="Iru Compliance">
    <Note>
      Finish the [**Workable**](#workable) 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 Workable">
        Find **Workable** (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** only (for example `mycompany`), not the full URL. Confirm server variables if the wizard shows a preview.
      </Step>

      <Step title="Paste the Bearer token">
        Paste the **Bearer** token when prompted.
      </Step>

      <Step title="Finish the connection">
        Click **Submit Bearer Token**. 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 **Workable** 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">
    Token expired; rotate.
  </Accordion>

  <Accordion title="Empty data">
    Add missing **read** scopes - new token required.
  </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>