Overview

Torii integrates with Sigma and syncs:

• Members, including their status and role (account type).
• Licenses, based on the account types assigned to your members.
• You can constantly stay updated with application information from our Integrations Page >> Integration Capabilities button >> Integration Capabilities table.

Requirements

Accounts & Permissions

To connect this integration, we require the following:

• A paid Sigma subscription. Free trials cannot create API credentials.
• Sigma API credentials owned by a member with the Admin account type. Sigma only returns data that the credentials' owner can access, so Admin-owned credentials are needed for Torii to read the full list of members and account types, and to manage members.
• To create the credentials, you must be assigned the Admin account type, or have the Create API keys permission assigned to your account type. Members with only the Create API keys permission can create credentials for themselves only. To create credentials owned by another member, you need the Admin account type.

Required keys

• API base URL - the Sigma API address for your organization (selected from a list in Torii).
• Client ID
• Client Secret

How to Generate the Required Values

Step 1: Find your API base URL

1. In Sigma, select your user avatar to open the user menu and select Administration.
2. In the side panel, select Developer access.
3. Your API base URL is shown at the top of the page. Note it down, you will select the matching option in Torii.

Step 2: Create the API client credentials

1. On the same Developer access page, click Create new. The Create client credentials window opens.
2. For Select scopes, select the checkbox for REST API.
3. For Name, enter a unique name, for example "Torii".
4. (Optional) For Description, enter a description of the purpose of the credentials.
5. For Owner, search for and select a member with the Admin account type. Calls to the API use the account type permissions assigned to this member. This field is available to admins only.
6. Click Create to generate the credentials.
7. Copy the client ID and the client secret and store them securely.

How to Connect the Integration

1. Go to the Integrations page in Torii.
2. Search for Sigma and click Connect.
3. For API base URL, select the option that matches the URL you noted in Sigma. Then enter your Client ID and Client Secret.
4. Click Connect.

Actions

The following actions are currently in beta. They run with the permissions of the member who owns the API credentials, which is why Admin-owned credentials are required.

• Create Sigma member - creates a member with the account type you choose.
• Update Sigma member - changes a member's account type, first name or last name.
• Deactivate Sigma member - deactivates the member (Sigma does not fully delete members) and reassigns their documents to the owner of the API credentials. Do not use it for members provisioned through SCIM.

For any further questions, please contact Torii Support.