OAuth providers
Deel
Set up Deel OAuth for global payroll, HR, and contractor management
Overview
Section titled “Overview”Connect your users to Deel for global payroll, HR management, and contractor payments.
| Property | Value |
|---|---|
| Provider ID | deel |
| Category | HR |
| PKCE | Supported |
| Token refresh | Automatic |
| Redirect URI | Shown in Developer Portal |
Step 1: Create a Deel OAuth App
Section titled “Step 1: Create a Deel OAuth App”Go to the Deel Developer Center
Navigate to Deel Developer Center and sign in.
Create a new app
Click Create New App.
Configure the application
Enter the application name and description. Add the Alter callback URL (from the Developer Portal) to the Redirect URI field.
Select scopes
Select the scopes the application needs. See Available Scopes below.
Get credentials
Copy the Client ID and Client Secret.
Step 2: Add to Alter Vault
Section titled “Step 2: Add to Alter Vault”Open the Developer Portal
Go to portal.alterauth.com and navigate to the application.
Add Deel provider
Go to OAuth Providers > Add Provider > Deel.
Enter credentials
- Client ID: Paste your Deel Client ID
- Client Secret: Paste your Deel Client Secret
Select scopes
Choose the scopes the application needs.
Save
Click Save. The provider is now active.
Available Scopes
Section titled “Available Scopes”Contracts
Section titled “Contracts”| Scope | Description |
|---|---|
contracts:read | Read access to contracts |
contracts:write | Write access to contracts |
People
Section titled “People”| Scope | Description |
|---|---|
people:read | Read access to people (employees and contractors) |
people:write | Write access to people |
Payments and Invoices
Section titled “Payments and Invoices”| Scope | Description |
|---|---|
payments:read | Read access to payment information |
invoices:read | Read access to invoices |
invoices:write | Write access to invoices |
Organizations
Section titled “Organizations”| Scope | Description |
|---|---|
organizations:read | Read access to organization information |
- For read-only HR integrations,
contracts:read,people:read, andorganizations:readprovide sufficient access. - See the Deel API documentation for more details on authentication and available endpoints.