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

# Deel

> Connect Deel to Iru Compliance with a scoped organization API token to collect worker roster, organization structure, and time-off records for onboarding and offboarding evidence.

### About Deel

Iru reads **workers**, **organization and legal entity structure**, and **time-off records** from the Deel API. Authentication uses an **organization API token** created in the **Developer Center** in your Deel dashboard. Tokens are **scope-bound** at creation. Grant only the **read** scopes your controls require.

### How It Works

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

Deel authenticates with a **Bearer** token against `https://api.letsdeel.com/rest`. There is no subdomain to configure.

Deel offers **organization** and **personal** tokens. A **personal token** is tied to the person who created it and **expires when that person leaves your company**, which can stop evidence collection without warning, including during offboarding. An **organization token** is not tied to an individual and does not expire. Use an organization token.

| Detail             | Value                           |
| ------------------ | ------------------------------- |
| **Category**       | HRIS                            |
| **Authentication** | Bearer (organization API token) |

Official references: [Authentication](https://developer.deel.com/api/authentication), [How to use the Deel API](https://help.letsdeel.com/hc/en-gb/articles/8801712601233-How-To-Use-Deel-API).

### Prerequisites

* An **Org Admin** or **IT Developer Admin** role in Deel. Only these roles can generate API tokens.
* Decide which scopes to grant. Deel scopes are read-specific, so you can collect roster and offboarding evidence without exposing compensation data.

### Connect Deel to Iru

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

    <Steps>
      <Step title="Sign in to Deel">
        Sign in to Deel as an **Org Admin** or **IT Developer Admin**.
      </Step>

      <Step title="Open the Developer Center">
        Go to **Apps & Integrations** → **Developer Center**.
      </Step>

      <Step title="Create an organization API token">
        Select **Create API Token** and choose **Organization** as the token type. Do not choose **Personal**. A personal token expires when its owner leaves the company.
      </Step>

      <Step title="Name the token">
        Enter a token name such as **Iru Compliance**, then continue.
      </Step>

      <Step title="Select read-only scopes">
        Select **read-only** scopes covering the evidence you need: `people:read` for the worker roster, `organizations:read` for legal entity and org structure, and `time-off:read` if a control depends on leave records. Grant `payslips:read` only if a control requires payroll data.
      </Step>

      <Step title="Generate and copy the token">
        Select **Generate**, then copy the token value **once** while Deel displays it.
      </Step>
    </Steps>

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

  <Tab title="Iru Compliance">
    <Note>
      Finish the [**Deel**](#deel) 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/tI0HDLDwHj8r9Ile/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=tI0HDLDwHj8r9Ile&q=85&s=87dcef15fc17d2fb9a6e53f454e41710" alt="Left navigation: Compliance expanded, Sources selected" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Turn on Deel">
        Find **Deel** (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="Paste the Bearer token">
        Paste the token into the **Bearer** field.
      </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 **Deel** 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="You cannot reach the Developer Center">
    Your Deel role is not **Org Admin** or **IT Developer Admin**. Ask someone with one of those roles to generate the token.
  </Accordion>

  <Accordion title="Authentication fails">
    Confirm the token is complete and has not been revoked, and check that the value was not truncated on copy.
  </Accordion>

  <Accordion title="Some records are missing">
    The token lacks the matching read scope. Deel scopes are fixed at creation. Generate a new token with the scopes you need.
  </Accordion>

  <Accordion title="Collection stopped after an employee left">
    A **personal** token was used and expired with its owner. Replace it with an **organization** token.
  </Accordion>
</AccordionGroup>

### Considerations

<CardGroup cols={2}>
  <Card title="Use an organization token" icon="circle-info">
    Use an **organization** token, not a **personal** token. Personal tokens expire when their owner leaves the company and can stop evidence collection during offboarding.
  </Card>
</CardGroup>

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