> ## Documentation Index
> Fetch the complete documentation index at: https://stackone-hub-docs-confluence-api-token-update.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Deel (OAuth)

> Follow these steps to connect Deel via the StackOne Hub successfully.

<Warning>
  Ensure that your Deel account has Admin privileges.
</Warning>

If you've been directed to StackOne to integrate with Deel, the following steps will help you understand the process and any necessary actions to configure a successful integration.

## Create your Client ID and Client Secret

This integration will authenticate on behalf of a registered application in Deel.

<Steps>
  <Step title="Navigate to the Deel Developer Center">
    In Deel, click **Hub** in the navigation menu, then select **Apps > Developer Center**.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Navigate to the Deel Developer Center" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/YuiSn9_H_qPKyg_D/images/deel/image1.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=70308fa6ccbe5121a0d2e0fd3b944170" width="2846" height="1020" data-path="images/deel/image1.png" />
    </Frame>
  </Step>

  <Step title="Create a new App">
    On the **Apps** tab, click the **Create new app** button.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Create a new App" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/YuiSn9_H_qPKyg_D/images/deel/image9.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=546f01ecc8dbb12274829af0d79a2aee" width="2910" height="1382" data-path="images/deel/image9.png" />
    </Frame>
  </Step>

  <Step title="Configure the App Details">
    <Info>
      We recommend using an **Organization** app type which is tied to the organization. Personal Apps tied to an individual and will expire once the user leaves the company.
    </Info>

    Configure the app with the following details

    * **App Type**: Organization
    * **App Name**: e.g. StackOne
    * **Redirect URL**: `https://api.stackone.com/connect/oauth2/deel/callback`
    * **Description**: e.g. StackOne
    * **Logo**: Any image (visible when authenticating)

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Configure the App Details" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/YuiSn9_H_qPKyg_D/images/deel/image10.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=24dbfd4de9b207d881ee79a893f30998" width="2960" height="1966" data-path="images/deel/image10.png" />
    </Frame>
  </Step>

  <Step title="Copy your Client ID and Client Secret">
    Copy your Client ID and Client Secret and store them safely to be used in a later step.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Copy your Client ID and Client Secret" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/YuiSn9_H_qPKyg_D/images/deel/image11.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=55de69eeb0fa99eaf6e80a3efcdba46d" width="2876" height="1674" data-path="images/deel/image11.png" />
    </Frame>
  </Step>
</Steps>

## Connecting with StackOne

<Steps>
  <Step>
    Upon reaching the Link Account page, enter the credential(s) from the previous steps:

    * **Client ID**
    * **Client Secret**
    * **Scopes** (optional)

    Proceed by clicking the Connect button.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Enter Credentials" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/YuiSn9_H_qPKyg_D/images/deel/image12.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=f6c6f6f9e8cdbe7e655447ba54790499" width="2498" height="1766" data-path="images/deel/image12.png" />
    </Frame>
  </Step>

  <Step title="Authorize Application">
    A new window will take you to Deel. If necessary, enter your Deel credentials or use one of the sign-in options available that are connected to your Deel account.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Authorize Application" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/YuiSn9_H_qPKyg_D/images/deel/image7.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=ff08cf503cbc35865e30bf895b7cda04" width="3588" height="1848" data-path="images/deel/image7.png" />
    </Frame>
  </Step>

  <Step title="Accept the required scopes">
    In order to connect to your Deel account, you need to grant permission for the App to access your data.

    Click **Allow** to proceed.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Accept permissions" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/YuiSn9_H_qPKyg_D/images/deel/image8.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=e924eb656dac99228256e6f800e4670f" width="1514" height="863" data-path="images/deel/image8.png" />
    </Frame>
  </Step>
</Steps>

<br />

Congratulations, you're all set! If you face any issues with the steps mentioned above,
please contact us by emailing [integrations@stackone.com](mailto:integrations@stackone.com). We're always here to assist you!

## Available data

This integration has the following [HRIS Resources](https://docs.stackone.com/reference/getting-started-with-your-api) available from the provider:

<ul>
  <li>Employees</li>
  <li>Employments</li>
  <li>Locations</li>
  <li>Companies</li>
  <li>Groups</li>
</ul>