Skip to main content
Any organization member can list members, but reading other people’s roles needs the Organization Admin role. Create the application as an Organization Admin, ideally a dedicated service account.

​
Choose your API base URL

Enter the API Base URL that matches your deployment, with no trailing slash.

  • Airbyte Cloud: https://api.airbyte.com/v1
  • Self-managed: https://<your-airbyte-host>/api/public/v1

​
Create an application

Applications hold the client ID and client secret the connector exchanges for access tokens.

1

Open the Applications page

In Airbyte, click your name, then User settings > Applications.

2

Create the application

Click Create an application, give it a descriptive name, and click Submit.

3

Copy the credentials

Copy the Client ID, then click the eye icon to reveal and copy the Client Secret.

​
Optional - add a SCIM token for user groups

User groups are read from Airbyte’s SCIM API, which needs the Pro or Enterprise Flex plan with SCIM enabled. In Airbyte, open Organization settings > SSO. In the SCIM section, copy the SCIM base URL. Copy the Bearer token as well; Airbyte shows it only once when SCIM is enabled or a new token is generated. Leave both fields empty if you do not use SCIM.

​
Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • API Base URL
  • Client ID
  • Client Secret
  • SCIM Token (Optional)
  • SCIM Base URL (Optional)
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account in your Accounts page.