Overview
Torii integrates with Remote and syncs:
| User Fields | License Types |
|---|---|
| Email, name, status, department, job title, manager, start date, termination date | Remote Employee, Remote Contractor, Remote Direct Employee, Remote Global Payroll Employee (based on the employment type in Remote) |
- You can constantly stay updated with application information from our Integrations Page >> Integration Capabilities button >> Integration Capabilities table.
- This integration is available behind a feature flag. To enable it for your organization, contact Torii Support.
Requirements
To connect this integration, we require the following:
Accounts & Permissions
- A Remote company account.
- A Remote company admin or company owner. Only they can create and revoke API tokens.
Required keys
- API Token - a Remote customer API token. To sync users, the token needs only the employment:read permission.
- (Optional) To use the Torii action that updates work emails, the token also needs employment:write.
How to Generate the Required Values
Follow these steps to generate the required values:
Step 1: Generate an API token
- Sign in to Remote as a company admin or company owner. A new Remote company must first finish Remote's company setup (legal company name, filing address, phone and tax details); until then the Remote API card asks you to add the missing details.
- Go to Company settings >> Integrations & APIs.
- On the Remote API card, click Access API, then Generate API token.
- Enter a name for the token (for example, Torii).
- Under the endpoint collections, select Custom endpoints and select View employments (employment:read). If you plan to use the Torii action, also select Manage employments (employment:write).
- Select the checkbox to agree to the Remote API Terms of Use and click Generate API Token.
- Click Copy token. Remote shows the token only once. Production tokens start with
ra_live_.
Important
Use a production token (starting with ra_live_). Tokens starting with ra_test_ only work in the Remote sandbox and will not connect to your live data.
How to Connect the Integration
- Go to the Integrations page in Torii.
- Search for Remote and click Connect.
- Paste the API token into the API Token field.
- Click Connect.
Update the User Lifecycle settings
To make sure you get user lifecycle information in Torii, define Remote as your HR management system.
- Go to Settings >> Users & Employees and, under User lifecycle, click Manage sources.
- Under Human Resource Management Systems, select Remote. If Remote is your only source for user management, make sure the other sources are unselected.
- Click Preview changes, then Apply changes.
Actions
- Update Remote work email - updates the work email of an existing employment. Requires the employment:write permission.
- Deleting a user is not supported. Offboarding must be done in Remote.
For any further questions, please contact Torii Support.