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

# Deel integration

> Description of your new file.

## **Overview**

To authenticate Deel, you will need to provide the following information:

* Organization Token

## **Prerequisites**

* You must be a Deel admin to complete the linking flow
* Your Deel account must have API access enabled. Contact your Deel account manager to confirm if you are unsure of this

## **Instructions**

### Method 1: User Credentials

This method is preferred and much quicker and easier.

**Step 1: Click “Connect” on the Deel integration**

Select `Use my credentials (recommended)`

<img src="https://mintcdn.com/brm-b1721f33/EfBz62NBctg77CZW/images/DEEL1.png?fit=max&auto=format&n=EfBz62NBctg77CZW&q=85&s=5a85e7b72b1702ab3493cd88b0796455" alt="DEEL1 Pn" title="DEEL1 Pn" style={{ width:"70%" }} width="1268" height="674" data-path="images/DEEL1.png" />

**Step 2: Click through the modal and a login window will pop-up**

BRM will only read data on employees, their employment status, and reporting line

<img src="https://mintcdn.com/brm-b1721f33/EfBz62NBctg77CZW/images/DEEL2.png?fit=max&auto=format&n=EfBz62NBctg77CZW&q=85&s=af292975328a0e2c6acac5ec60af09c3" alt="DEEL2 Pn" title="DEEL2 Pn" style={{ width:"70%" }} width="1264" height="674" data-path="images/DEEL2.png" />

**Step 3: Login to Deel and click allow**

Note: the auth screen consists of boilerplate language, BRM will not manage anything in Deel and can only read data on employees, their employment status, and reporting line

<img src="https://mintcdn.com/brm-b1721f33/EfBz62NBctg77CZW/images/DEEL3.png?fit=max&auto=format&n=EfBz62NBctg77CZW&q=85&s=e39f57f5c0db91eb68ca3f4e9d5985ae" alt="DEEL3 Pn" title="DEEL3 Pn" style={{ width:"70%" }} width="1264" height="676" data-path="images/DEEL3.png" />

## Method 2: API Token

**Step 1: Create an organization token**

1. In your Deel portal, go to Apps & Integrations on the left-hand side
2. In the upper right, go to developer center
3. Click generate new token under organization tokens
4. Label your organization token and click next
5. Select all scopes to add to your organization token and click generate

<img src="https://mintcdn.com/brm-b1721f33/EfBz62NBctg77CZW/images/DEEL4.png?fit=max&auto=format&n=EfBz62NBctg77CZW&q=85&s=5b5569e4c9f4163a5401818a74e591f4" alt="DEEL4 Pn" title="DEEL4 Pn" style={{ width:"68%" }} width="1268" height="492" data-path="images/DEEL4.png" />

<img src="https://mintcdn.com/brm-b1721f33/EfBz62NBctg77CZW/images/DEEL5.png?fit=max&auto=format&n=EfBz62NBctg77CZW&q=85&s=585c42f69c01f2602185a4dad91a908e" alt="DEEL5 Pn" title="DEEL5 Pn" style={{ width:"68%" }} width="1274" height="588" data-path="images/DEEL5.png" />

<img src="https://mintcdn.com/brm-b1721f33/EfBz62NBctg77CZW/images/DEEL6.png?fit=max&auto=format&n=EfBz62NBctg77CZW&q=85&s=482063f673aaa8b73271b4d8da405037" alt="DEEL6 Pn" title="DEEL6 Pn" style={{ width:"69%" }} width="1274" height="1098" data-path="images/DEEL6.png" />

<img src="https://mintcdn.com/brm-b1721f33/EfBz62NBctg77CZW/images/DEEL7.png?fit=max&auto=format&n=EfBz62NBctg77CZW&q=85&s=c566822bcfe6c847e012bb3b6d9b99fc" alt="DEEL7 Pn" title="DEEL7 Pn" style={{ width:"69%" }} width="1260" height="1072" data-path="images/DEEL7.png" />

<img src="https://mintcdn.com/brm-b1721f33/EfBz62NBctg77CZW/images/DEEL8.png?fit=max&auto=format&n=EfBz62NBctg77CZW&q=85&s=67e16ddf284f36d9ffb1460824ff3562" alt="DEEL8 Pn" title="DEEL8 Pn" style={{ width:"69%" }} width="838" height="1476" data-path="images/DEEL8.png" />

**Step 2: Enter your token in the linking flow**

<img src="https://mintcdn.com/brm-b1721f33/EfBz62NBctg77CZW/images/DEEL9.png?fit=max&auto=format&n=EfBz62NBctg77CZW&q=85&s=f330a4bee6609470fdfd3230f8850725" alt="DEEL9 Pn" title="DEEL9 Pn" style={{ width:"70%" }} width="836" height="1590" data-path="images/DEEL9.png" />
