> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Airbyte with OAuth 2.0 (Client Credentials) – StackOne Hub

> Link a Airbyte account in the StackOne Hub using OAuth 2.0 (Client Credentials). End-user guide to authorize the integration and start using Airbyte actions.

> [!WARNING]
>
> 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

Airbyte answers API calls at a different address for each kind of deployment, so StackOne needs the one that matches yours. If you open the Airbyte UI at `cloud.airbyte.com`, you are on Airbyte Cloud. If you open it at an address your own team runs, your deployment is self-managed.\
\
Enter the matching value in the **API Base URL** field in StackOne Hub, with no trailing slash.

<ul>
  <li>**Airbyte Cloud**: enter `https://api.airbyte.com/v1`.</li>
  <li>**Self-managed**: enter `https://your-airbyte-host/api/public/v1`, replacing `your-airbyte-host` with the host you use to open the Airbyte UI.</li>
</ul>

## Create an application

Applications hold the client ID and client secret the connector exchanges for access tokens. The application acts as the user who created it and inherits that user's permissions.

**1. Open the Applications page**

Sign in to [Airbyte Cloud](https://cloud.airbyte.com), click your name at the bottom of the left sidebar, and choose **User settings**. Airbyte opens **Profile**, so select **Applications** from the **Account** list.

![The Airbyte sidebar with the user name menu open and User settings highlighted](https://mintcdn.com/stackone-60/6kf49W4y05g0bbhA/connectors/airbyte/images/oauth-2-0-config-user-settings-menu.png?fit=max\&auto=format\&n=6kf49W4y05g0bbhA\&q=85\&s=ccd5d2c5729d810bbdbf528ad3810e22)

**2. Create the application**

Click **Create an application** in the top right. Under **Name your application**, enter `StackOne Integration`, then click **Submit**.

<ul>
  <li>Self-managed (Core) deployments already have one application ready under **Applications**, so skip this step.</li>
</ul>

![The Create an application dialog with the name filled in and the Submit button highlighted](https://mintcdn.com/stackone-60/6kf49W4y05g0bbhA/connectors/airbyte/images/oauth-2-0-config-create-application.png?fit=max\&auto=format\&n=6kf49W4y05g0bbhA\&q=85\&s=3255a72764afafc1ce232f03cd6d9531)

**3. Copy the credentials**

Your application appears in the table under **Client ID** and **Client Secret**. Copy the client ID into the **Client ID** field in StackOne Hub. Click the eye icon beside the masked client secret to reveal it, then copy it into the **Client Secret** field. You can reveal the secret again whenever you need it.

![The Applications table showing the new application with the eye icon that reveals the client secret highlighted](https://mintcdn.com/stackone-60/6kf49W4y05g0bbhA/connectors/airbyte/images/oauth-2-0-config-copy-credentials.png?fit=max\&auto=format\&n=6kf49W4y05g0bbhA\&q=85\&s=54a06a32be17d36ffb51ea0d8dd183c1)

## Optional - add a SCIM token for user groups

User groups are read from Airbyte's SCIM API. SCIM is an add-on to single sign-on that Airbyte turns on for your organization on request, so contact Airbyte before you start. Leave the **SCIM Token** and **SCIM Base URL** fields empty if you do not use SCIM.

<ul>
  <li>The **SSO** tab appears under **Organization settings** only on the Plus, Pro, and Enterprise Flex plans. On Core and Standard the tab is absent and SCIM is unavailable.</li>
  <li>SCIM itself needs the Pro or Enterprise Flex plan, with SCIM enabled for your organization by Airbyte.</li>
</ul>

**1. Open the SCIM section**

In Airbyte, click **Organization settings** in the left sidebar, then open the **SSO** tab and find the SCIM section.

**2. Enable SCIM**

Choose your **Identity provider**, then click **Enable SCIM**. Airbyte shows a **SCIM base URL** and a **Bearer token**.

**3. Copy the values into StackOne Hub**

Copy the **SCIM base URL** into the **SCIM Base URL** field and the **Bearer token** into the **SCIM Token** field in StackOne Hub. Airbyte shows the bearer token only once, and keeps showing the base URL afterwards. If you lose the token, click **Generate new token** to issue a replacement.

## Link the Account

**1. Connect**

<ul>
  <li>Click **Connect**.</li>
  <li>If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider's authorization flow.</li>
  <li>Once authorization is successful, you will see a confirmation popup.</li>
</ul>

**2. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/connect/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.