Skip to main content

​
Creating an OAuth app

StackOne connects to Deel through an OAuth app registered in your Deel Developer settings. The app provides the Client ID and Client Secret for the StackOne Connector profile.

1

Sign in to Deel

Sign in to the Deel account for the environment you are connecting:

  • Production — Deel production sign-in
  • Sandbox — Deel demo sign-in
  • The steps below are identical in both environments; the screenshots show production.
  • Create the app in the same environment you select in the StackOne Connector profile — Client ID and Client Secret are different per environment.
The Deel sign-in page with the Email field and the Log in button highlighted
2

Open Organization settings

Click the Organization settings gear icon in the top bar.

The Deel home page with the Organization settings gear icon in the top bar highlighted
3

Open the Developer apps page

In All Settings, scroll to the Services group in the left menu.

  • Click Developer to expand it.
  • Click Apps.
The All Settings menu with Developer expanded and the Apps entry highlighted
4

Register as a developer

If the Apps tab shows You need to create a developer account, click Create account. Skip this step if your organization already has a developer account.

  • In Create a developer account, check the prefilled Company name.
  • Enter your Company website, for example https://www.example.com.
  • Enter a Description, for example Integration with StackOne.
  • Click Confirm, then click OK on Thanks for registering for a developer account.
The Create a developer account dialog with the Company name, Company website and Description fields and the Confirm button highlighted
5

Start a new app

On the Apps tab, click Create an app.

The Apps tab of the Developer page with the Create an app button highlighted
6

Fill in the app details

In Create an app, complete the form.

  • App type: select Organization.
  • App name: StackOne Integration
  • Redirect URL: https://api.stackone.com/connect/oauth2/deel/callback
  • Description: Integration with StackOne
  • App icon: upload a PNG (maximum 1MB). In the App icon dialog that opens, click Upload logo. The Create button stays disabled until an icon is uploaded.
  • Click Create.
The Create an app form with the Organization app type, App name, Redirect URL and Description fields and the Create button highlighted
7

Copy the app credentials

The app’s credentials dialog opens as soon as the app is created. Copy both values and store them securely for use later.

  • Key — click Copy next to it and paste it into the Client ID field in the StackOne Connector profile.
  • Secret — click Copy next to it and paste it into the Client Secret field in the StackOne Connector profile.
  • The Secret is shown only once. If you lose it, you must create a new app.
  • Download as JSON saves both values to a file if you prefer.
  • Click Close.
  • To see the Key again later, open the app’s Actions menu on the Apps tab and click Show Credentials.
The app credentials dialog with the Secret value masked and the Copy buttons for Key and Secret highlighted

​
Choosing the OAuth scopes

Deel apps do not configure scopes in the Developer settings. StackOne requests the scopes during authorization, and the Deel admin who connects the account approves them on the Deel consent screen.

1

Enter the scopes to request

Enables actions: Calculate EOR Employment Cost, Cancel Time Off Request, Create ATS Application, Create ATS Candidate, Create ATS Job, Create Contract, Create Group, Create Legal Entity, Create Manager, Create Organization Structure, Create Role, Create Time Off Request, Create Timesheet, Create Worker Relation, Create Worker Relation Type, Delete Group, Delete Legal Entity, Delete Organization Structure, Delete Timesheet, Delete Worker Relation, Delete Worker Relation Type, Get ATS Application, Get ATS Job Posting, Get Contract, Get EOR Hiring Guide By Country, Get Invoice, Get Organization, Get Organization Structure, Get Person, Get Timesheet Preset, Get Work Schedule And Holidays, List ATS Applications, List ATS Candidates, List ATS Departments, List ATS Employment Types, List ATS Job Postings, List ATS Jobs, List ATS Locations, List ATS Offers, List Adjustment Categories, List Contract Templates, List Contracts, List Deel Invoices, List Departments, List EOR Benefits, List EOR Job Scope Templates, List GP Payroll Events By Legal Entity, List GP Worker Payslips, List Groups, List Invoices, List Legal Entities, List Managers, List Offboarding, List Onboarding Employees, List Organization Structures, List Organization Tasks, List Payments, List People, List People Custom Fields, List Roles, List Time Off Policies, List Time Off Requests, List Time Tracking Shift Rates, List Time Tracking Shifts, List Timesheet Presets, List Timesheets, List Webhooks, List Worker Relation Types, List Worker Relations, List Working Locations, Retrieve A List Of ATS Teams, Review Time Off Requests, Review Timesheet, Update Group, Update Legal Entity, Update Organization Structure, Update Role, Update Time Off Request, Update Timesheet, Update Worker Relation Type

In the Scopes field of the StackOne Connector profile, enter the Deel OAuth scopes to request, separated by a space. Leave the field empty to request the connector’s default scopes. The scopes used by this connector’s actions are listed below.

​
Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for Deel:
1

Navigate to Connector Profiles

Login to StackOne and navigate to Connector Profiles
2

Create New Connector Profile

  • Click + Connector Profile
  • Search for and select Deel
  • Select Type as OAuth 2.0
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
    • Scopes (Optional)
  • (Optional) Select Actions to be enabled for this Connector Profile
  • Click Create profile
Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to Link Accounts for Deel.