Overview

Torii integrates with Supermetrics and syncs:

• Team members: name, email, role and the date they were added to the team. All listed team members are shown as active.
• Licenses: a single Supermetrics license counting the team members. Supermetrics does not expose seat assignment through its API, so this number is an upper bound on the seats in use.
• Supermetrics does not provide a last-used date, so it is not synced.
• You can constantly stay updated with application information from our Integrations Page >> Integration Capabilities button >> Integration Capabilities table.

Requirements

To connect this integration, we require the following:

Accounts & Permissions

• A Supermetrics account with the Admin or Owner role. Only account admins and owners can create API keys.
• A Supermetrics plan with Platform API access, which includes team management through the API. Supermetrics lists it in the Enterprise plan.

Required keys

• API key with the scopes team_users_read (to read the members of your team) and team_read (to read your team name).
• Team ID: the numeric ID of your Supermetrics team.

How to Generate the Required Values

Step 1: Create an API key

1. Sign in to the Supermetrics Hub.
2. Click your avatar in the top-right corner and select API keys.
3. Click Create API key.
4. Enter a name (for example, Torii) and select only the scopes team_users_read and team_read.
5. Click Create API key and copy the key.

If you later use Torii actions that add, change or remove team members, the key also needs the team_users_write scope.

Step 2: Find your Team ID

1. In the Supermetrics Hub, open the Team page, where Supermetrics shows your team ID.
2. Use the numeric team ID (for example, 936506).
3. Do not use the team display ID that starts with SM_. It is not accepted and the connection will fail.
4. If you cannot find the numeric ID, contact Supermetrics support and ask for the team ID of your team.

How to Connect the Integration

1. Go to the Integrations page in Torii.
2. Search for Supermetrics and click Connect.
3. Enter the API key and the Team ID.
4. Click Connect.

Actions

To use these actions, the API key needs the team_users_write scope, and the key must belong to an Admin or Owner.

• Invite Supermetrics user: invites a user to your team with the role you choose. The user must have a Google or Microsoft email address, and appears in Supermetrics only after accepting the invitation.
• Change Supermetrics user role: changes a team member's role. Admins can't change an Owner's role. Only an Owner can.
• Remove Supermetrics user: removes a member from your team.

For any further questions, please contact Torii Support.