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

# Deel OAuth 2.0 connector profile – StackOne setup guide

> Set up the OAuth 2.0 connector profile for Deel in StackOne. One-time admin setup required before your users can link Deel accounts via Hub.

<section data-guide-section data-guide-scopes="">
  <h2>Choosing Your Environment</h2>

  <p>Deel provides separate environments for development and production. Each requires its own OAuth app registration.</p>

  <Steps>
    <Step title="Select the right environment">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>When connecting Deel to StackOne, you will be asked to select an environment.</p>

        <ul>
          <li><strong>Production</strong> — Uses your live Deel organization at `app.deel.com`</li>
          <li><strong>Sandbox</strong> — Uses simulated data for testing at `app.demo.deel.com`</li>
          <li>You must create a separate OAuth app in each environment</li>
          <li>Client ID and Client Secret are different per environment</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Create an OAuth App</h2>

  <p>Register an OAuth application in the Deel Developer Center to enable user-authorized API access.</p>

  <Steps>
    <Step title="Open the Developer Center">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Sign in to the Deel account for your target environment and navigate to the Developer Center.</p>

        <ul>
          <li><strong>Production</strong> — Sign in at <a href="https://app.deel.com/" target="_blank" rel="noopener noreferrer">app.deel.com</a>. Click <strong>More</strong> in the top navigation bar, then select <strong>Developer</strong> from the products and services grid. Click the <strong>Apps</strong> tab.</li>
          <li><strong>Sandbox</strong> — Sign in at <a href="https://app.demo.deel.com/" target="_blank" rel="noopener noreferrer">app.demo.deel.com</a>. Click the <strong>Settings</strong> icon (gear) in the top bar, then scroll to the <strong>Services</strong> section in the left sidebar and click <strong>Developer</strong> > <strong>Apps</strong>.</li>
        </ul>
      </div>
    </Step>

    <Step title="Register a new app">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Click <strong>Create new app</strong> and complete the registration form.</p>

        <ul>
          <li>Select <strong>Organization</strong> as the app type (recommended)</li>
          <li>Enter a descriptive app name (e.g., "StackOne Integration")</li>
          <li>Set the <strong>Redirect URL</strong> to `https://api.stackone.com/connect/oauth2/deel/callback`</li>
          <li>Add a description for the app</li>
          <li>Optionally upload an app icon (.PNG format, max 1MB)</li>
          <li>Click <strong>Create</strong></li>
        </ul>
      </div>
    </Step>

    <Step title="Copy and store credentials">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>After creation, copy the Client ID and Client Secret immediately.</p>

        <ul>
          <li>Copy the <strong>key</strong> — this is your Client ID</li>
          <li>Copy the <strong>secret</strong> — this is your Client Secret</li>
          <li><strong>Critical</strong> — The secret is shown only once. Store it securely for use later</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Matching Credentials to Environment</h2>

  <p>Ensure your OAuth credentials match the environment you selected in StackOne.</p>

  <ul>
    <li>If you selected <strong>Production</strong>, use the Client ID and Secret from `app.deel.com`</li>
    <li>If you selected <strong>Sandbox</strong>, use the Client ID and Secret from `app.demo.deel.com`</li>
    <li>Using credentials from the wrong environment will cause authentication errors</li>
  </ul>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Important Notes</h2>

  <p>Key information about Deel OAuth 2.0 authentication.</p>

  <ul>
    <li>Access tokens expire after 30 days</li>
    <li>Refresh tokens expire after 90 days and are single-use</li>
    <li>Each refresh invalidates the previous refresh token — always store the new one</li>
    <li>Reusing an already-exchanged refresh token may trigger revocation of all tokens</li>
  </ul>
</section>

## Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for <strong>Deel</strong>:

<Steps>
  <Step title="Navigate to Connector Profiles">
    Login to StackOne and navigate to [Connector Profiles](https://app.stackone.com/connector_profiles)
  </Step>

  <Step title="Create New Connector Profile">
    <ul>
      <li>Click <strong>+ Connector Profile</strong></li>
      <li>Search for and select <strong>Deel</strong></li>
      <li>Select <strong>Type</strong> as <strong>OAuth 2.0</strong></li>

      <li>
        Fill out the fields using details retrieved from your provider:

        <ul style={{ marginLeft: '20px' }}>
          <li><strong>Client ID</strong></li>
          <li><strong>Client Secret</strong></li>
          <li><strong>Scopes</strong> (Optional)</li>
        </ul>
      </li>

      <li>(Optional) Select <strong>Actions</strong> to be enabled for this Connector Profile</li>
      <li>Click <strong>Create profile</strong></li>
    </ul>
  </Step>
</Steps>

Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to <a href="/guides/accounts-section#linking-accounts">Link Accounts</a> for <strong>Deel</strong>.