Skip to content

Reference

Deel

Set up Deel OAuth for global payroll, HR, and contractor management

Connect your users to Deel for global payroll, HR management, and contractor payments.

PropertyValue
Provider IDdeel
CategoryHR
PKCESupported
Token refreshAutomatic
Redirect URIShown in Developer Portal

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.

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.

ScopeDescription
contracts:readRead access to contracts
contracts:writeWrite access to contracts
ScopeDescription
people:readRead access to people (employees and contractors)
people:writeWrite access to people
ScopeDescription
payments:readRead access to payment information
invoices:readRead access to invoices
invoices:writeWrite access to invoices
ScopeDescription
organizations:readRead access to organization information
  • For read-only HR integrations, contracts:read, people:read, and organizations:read provide sufficient access.
  • See the Deel API documentation for more details on authentication and available endpoints.

Alter policy rules can target these attested operations and families for operation-level and parameter-aware controls.

Operation IDFamiliesMethodProvider path
webhooks/deleteadmin, deleteDELETE/rest/webhooks/{id}
webhooks/createadmin, writePOST/rest/webhooks
webhooks/updateadmin, writePATCH/rest/webhooks/{id}
contracts/createwritePOST/rest/contracts
contracts/terminatewritePOST/rest/contracts/{contract_id}/terminations
organizations/create-childwritePOST/rest/organizations/children
timesheets/createwritePOST/rest/timesheets
contracts/getreadGET/rest/contracts/{contract_id}
contracts/listreadGET/rest/contracts
groups/listreadGET/rest/groups
invoice-adjustments/listreadGET/rest/invoice-adjustments
lookups/countriesreadGET/rest/lookups/countries
lookups/currenciesreadGET/rest/lookups/currencies
lookups/job-titlesreadGET/rest/lookups/job-titles
organizations/getreadGET/rest/organizations
timesheets/listreadGET/rest/timesheets
webhooks/getreadGET/rest/webhooks/{id}
webhooks/listreadGET/rest/webhooks

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.