Overview

Torii integrates with Deel and syncs:

• Torii supports syncing multiple Deel accounts.
• You can constantly stay updated with application information from our Integrations Page
  >> Integration Capabilities button >> Integration Capabilities table.
• Torii syncs users from both the People table and the Admins table in Deel.

Requirements

Accounts & Permissions

• To connect this integration, we require the following:
  • Organization Token

How to Generate the Required Values

1. Log into your Deel account.
2. Click More → Developer
   
   
3. Click Generate new token.
   
4. Enter a Label for the token and select Organization token, then click Next.
   
5. Select the following scopes:
   1. Under People → people:read

   2. Under Organiztions → organiztions:read
      
6. Under Sensitive Data, select Employment information to hide this info, and click Next.
7. Click Generate.
   
8. Copy the token immediately — it will not appear again.

How to Connect the Integration

1. Go to the Integrations page in Torii.

2. Select the Deel tile.

   

3. Click Connect.

   

4. Enter the Organization Token.

   

5. Click Connect to finalize the integration.

6. Once the integration is connected and synced, a green checkbox will appear next to the integration.

   

Additional Info

User details

Torii syncs users from both the People table and the Admins table in Deel.

• If a user returns only from the People table, their 'Role' field will be empty in Torii (Deel does not return any information on the user role from their API). 
• If a user returns only from the Admins table, their status will always be 'Active', and only the user's email and name will be synced (additional user fields do not exist in the Admins table).. 
• If a user appears in both lists, the user's data will be based on the People table, and their 'Role' field will show 'Admin'. 

User lifecycle status

An important distinction relevant for using Deel as your user's lifecycle source of truth:

• If a user is only listed under the Admin table, they will be considered past users once they are deleted from that table.
• If a user is only listed under the People table, they will be considered past users once their status is changed to inactive, or if they are removed from that table.
• However, if the user is listed under both the Admin and People tables, they must be removed from both tables (or removed from the Admin table and marked as inactive in the People table) to be considered a past user.
• You can learn more about user lifecycle status here.

Actions

• The people:write scope is required for the "Update Deel user" and "Update Deel user working location" actions.
• The organizations:write scope is required for the "Create Deel admin" action.
  Please note that the "Update Deel user" and "Update Deel user working location" actions only work for user objects retrieved from the People table.
•  

For any further questions, please contact Torii Support.