Overview

Torii integrates with Parabol and syncs:

• Users of your Parabol organization, including their role and last visit time.
• Licenses, based on your organization's Parabol plan.
• 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 Parabol account that is a member of the organization you want to connect.
• Parabol API access is available on every Parabol plan, including the free Starter plan.
• To invite users, the token owner must be a member of the team you invite them to.
• To remove users or change roles, the token owner must be an Org admin or a Billing leader. Granting the Org admin role, or changing the role of a current Org admin, needs an Org admin.

Required keys

• Personal Access Token - a Parabol personal access token (starts with pat_) with the minimal scopes below.
  • To sync users and licenses: Users Read and Organizations Read.
  • To also use actions, add: Teams Read (to list teams for invitations), Teams Write (to invite users), and Organizations Write (to remove users and change roles).
  • The token's resource grants must include your organization.
• Organization ID - the ID of the Parabol organization to connect.

How to Generate the Required Values

Follow these steps to generate the required values:

Step 1: Create a personal access token

1. Sign in to Parabol and click your avatar, then go to Profile.
2. Open Personal Access Tokens and click New Token.
3. Select only the scopes you need: Users Read and Organizations Read for syncing. If you want to use actions, also select Teams Read, Teams Write, and Organizations Write.
4. Make sure the resource grants include your organization.
5. Set an expiration date. A token can be valid for up to 1 year.
6. Create the token and copy it.

Step 2: Find your Organization ID

1. In Parabol, open your organization page.
2. Look at the page URL, for example https://action.parabol.co/me/organizations/<orgId>/billing.
3. Copy the part right after /me/organizations/ (<orgId>). This is your Organization ID.

How to Connect the Integration

1. Go to the Integrations page in Torii.
2. Search for Parabol and click Connect.
3. Enter the Personal Access Token and the Organization ID.
4. Click Connect.

Actions

• Invite User - invites a user by email to a Parabol team that you select. The user must accept the invitation, and appears in Torii after they join and the next sync runs. The token owner must be a member of the selected team. If no invitation is sent, for example because the user is already on the team, the action fails and shows the reason from Parabol.
• Remove User - removes a user from your Parabol organization and all of its teams. The user's Parabol account is not deleted.
• Update User Role - changes a user's role in the organization to Billing leader, Org admin, or Member. Granting Org admin requires a token owned by an Org admin.

For any further questions, please contact Torii Support.