Overview

Torii integrates with GitHub Teams and syncs:

• Torii supports syncing multiple GitHub Teams accounts.
• 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:
  • Organization Name
  • OAuth Scopes:
    • read:org – Read organization data
    • read:user – Read members/outside collaborators/blocked users (not pending invitations)
    • admin:org – Needed for fetching pending invitations

How to Generate the Required Values

1. Identify the GitHub Organization Name you wish to connect.

2. Ensure you are an admin or have the required permissions to approve access for this GitHub organization.

3. During the integration setup, you will be redirected to GitHub's OAuth login screen.

4. Log in with your GitHub credentials and approve access to the relevant organization.

How to Connect the Integration

1. Go to the Integrations page in Torii.
2. Select the GitHub Teams tile.
   
3. Click Connect.
4. Enter the Organization Name you wish to connect.
   
5. You will be redirected to GitHub to authenticate and approve access.

At this stage, you’ll see the GitHub authorization screen, where you must grant Torii access to the organization(s) you want to connect.

⚠️ If you have more than one GitHub organization you’d like to connect, you must grant access to all of them during this first authorization step. GitHub will not show you the option to add additional organizations later. In Torii, each organization should still be connected as a separate account.

6. After approval, you’ll be redirected back to Torii.
7. Once the integration is connected and synced, a green checkbox will appear next to the integration.
   

Q&A

Q: What should I do if I want to grant access to an additional GitHub organization after the integration was already connected?

A: GitHub does not allow adding organizations to an existing authorization. To connect an additional organization, you will need to revoke the Torii app authorization and reconnect:

1. In GitHub, go to Settings > Applications > Authorized OAuth Apps.
2. Select the Torii application.
3. Click Revoke to remove the authorization.
4. Go back to Torii and reconnect the GitHub Teams integration.
5. During the first connection screen in GitHub, make sure to grant access to all the organizations you want Torii to sync. (Each organization will still need to be connected as a separate account in Torii.)

Once this is done, you will see the consent screen again, with the option to approve the required organizations.

For any further questions, please contact Torii Support.