Overview
Torii integrates with Airbyte and syncs:
- Users (name and email) of your Airbyte organization, together with their organization role (for example, Organization Admin).
- 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
- An Airbyte Cloud or self-managed Airbyte account. The Airbyte API is available on every Airbyte plan.
- An Airbyte user with the Organization Admin role in the organization you want to connect. The application you create acts with the same permissions as the Airbyte user who creates it, and Organization Admin is needed to read each user's role.
Required keys
- Airbyte Deployment - Airbyte Cloud or Self-Managed.
- Airbyte URL - self-managed only, for example https://airbyte.example.com (no trailing slash).
- Organization ID
- Client ID
- Client Secret
How to Generate the Required Values
Step 1: Choose the Airbyte user
- Recommended minimal setup: create a dedicated Airbyte user with the Organization Admin role in the one organization you want to connect, and sign in as that user.
- Using a personal Organization Admin account also works, but it ties the connection to that person.
Step 2: Create an application
- In Airbyte, open the user menu and go to User settings >> Applications.
- Click Create an application and give it a name (for example, Torii).
- Copy the Client ID.
- Reveal and copy the Client Secret.
Step 3: Find your Organization ID
- In Airbyte, go to Organization settings >> General and copy the ID.
- While you are in Organization settings, the ID also appears in the address bar, after /organization/.
- Alternatively, call the Airbyte API endpoint GET /v1/organizations and copy the ID of your organization.
How to Connect the Integration
- Go to the Integrations page in Torii.
- Search for Airbyte and click Connect.
- Select your Airbyte Deployment. For Self-Managed, also enter your Airbyte URL.
- Enter the Organization ID, Client ID and Client Secret.
- Click Connect.
Q&A
Q: Why don't I see some of my Airbyte users in Torii?
A: Torii syncs the members of your Airbyte organization. Users who only have access to a workspace, and are not organization members, are not listed by Airbyte and therefore do not appear in Torii.
Q: Why don't invited users appear in Torii?
A: Airbyte lists a user only after they accept the invitation. Invited users appear in Torii on the first sync after they accept.
Q: Does Torii sync Airbyte licenses?
A: No. Airbyte has no per-seat licenses, so all listed users are shown as active and no license data is synced.
For any further questions, please contact Torii Support.