Apps

A common use case for OAuth2 is to create apps for your organization or for the App Store to enhance some functionalities or to connect with third-party services.

📘

Only client users can use OAuth2 apps

To use an OAuth2 app, users must have a client role in Deel. Other roles, such as employees or independent contractors, cannot use OAuth2 apps.

Create an app

To create an app:

1. Go to More > Developer.

   

2. On the Developer Center page, go to the Apps tab, and click Create new app.

   

3. Select the app type, fill the form with the app details, then click Create.

   

📘

The secret is only shown once when the app creation is confirmed. Store your secret somewhere safe or download the JSON file to make sure you don't lose access to it.

The app is created and ready to use.

👍

Apps are only available internally until approved

Once you create an app, it will be reviewed by our team. Until the app is approved, only users within your organization can use it. Once the app it's approved, also users outside of your organization will be able to use it.

Organization apps and personal apps

Organization apps generate organization-level access tokens. These tokens are not tied to a user and can access all data in the organization. Personal apps generate personal access tokens limited to a user’s access.

For example, if you have an organization app when the Deel client gives you consent to read their contracts data, you can access all contracts in that organization even if the admin does not have access to a specific contract. With personal apps, you will only be able to access contracts the admin has access to.

📘

All OAuth apps created before May 30th, 2023 are personal apps.