Skip to main content

​
Choosing Your Environment

Deel provides separate environments for development and production. Choose the appropriate environment based on your use case.

1

Select the right environment

When connecting Deel to StackOne, you will be asked to select an environment.

  • Production — Uses your live Deel organization with real employee and contractor data at app.deel.com
  • Sandbox — Uses simulated data for testing at app.demo.deel.com. Create a sandbox from the Developer Center if you don’t have one
  • Each environment requires its own API token
  • You can switch environments later by creating a new connection

​
Generate an API Token

Create an API token in the Deel Developer Center to authenticate API requests.

1

Open the Developer Center

Sign in to your Deel account and navigate to the Developer Center.

  • Production — Sign in at app.deel.com. Click More in the top navigation bar, then select Developer from the products and services grid. You will land on the Access Tokens tab.
  • Sandbox — Sign in at app.demo.deel.com. Click the Settings icon (gear) in the top bar, then scroll to the Services section in the left sidebar and click Developer > Tokens.
2

Create a new token

On the Access Tokens tab, click Generate new token to open the token creation wizard.

  • Step 1 — Token details — Enter a descriptive label (e.g., “StackOne Integration”) and select Organization token type (recommended)
  • Step 2 — Select scopes — Choose the required API scopes for your integration
  • Step 3 — Permission levels — Configure the permission levels
  • Step 4 — Select groups — Choose which groups to grant access to
  • Step 5 — Sensitive data — Configure sensitive data access permissions
  • Step 6 — Review — Review your settings and confirm token creation
3

Copy and store the token

Copy the generated token immediately and store it securely for use later.

  • Critical — The token is shown only once. You cannot retrieve it after closing this page
  • If the token is lost, you must generate a new one

​
Matching Your Token to Your Environment

Ensure your API token matches the environment you selected in StackOne.

  • If you selected Production, use a token generated from app.deel.com
  • If you selected Sandbox, use a token generated from app.demo.deel.com
  • Using a token from the wrong environment will cause authentication errors

​
Important Notes

Key information about Deel API token authentication.

  • Organization tokens grant access to all organizational resources (contracts, timesheets, invoices, accounting, SCIM)
  • Personal tokens are limited to user-specific resources (contract creation, SSO)
  • Tokens do not expire but can be revoked from the Developer Center
  • Rotate credentials quarterly or when team members depart

​
Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • API Token
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account in your Accounts page.