> ## 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.

# JetBrains YouTrack OAuth 2.0 connector profile – StackOne setup guide

> Set up a connector profile using OAuth 2.0 for JetBrains YouTrack in StackOne to allow users to link their accounts.

> [!WARNING]
>
> OAuth client registration needs YouTrack 2026.2 or later (native registration) or an admin-configured external Hub on older/self-hosted deployments. If your instance does not meet this, use the Permanent Token method instead.

## Register a service in Hub

Sign in to your YouTrack instance's Hub, then register a service for StackOne.

**1. Open Services**

Go to your Hub URL (`<your YouTrack URL>/hub`), then click **Services** in the top navigation bar.

![The Hub Services page listing existing services with the New service button highlighted.](https://mintcdn.com/stackone-60/reQr1IRXGxtor6PF/connectors/jetbrains/images/oauth2-setup-services.png?fit=max\&auto=format\&n=reQr1IRXGxtor6PF\&q=85\&s=be79270e4683ce8a84bf2b3f4a05d4cf)

**2. Create the service**

Click **New service …** and fill in the **New Service** dialog.

<ul>
  <li>**Name**: `StackOne Integration`</li>
  <li>Click **Create**.</li>
</ul>

![The New Service dialog with the Name field filled in and the Create button highlighted.](https://mintcdn.com/stackone-60/reQr1IRXGxtor6PF/connectors/jetbrains/images/oauth2-setup-new-service.png?fit=max\&auto=format\&n=reQr1IRXGxtor6PF\&q=85\&s=fa90e3e5319a19a4f9ec01a17cf5c9c6)

## Enable the Authorization Code flow

Creating the service opens its **Authentication** tab, where the OAuth flow and redirect\
URI are configured.

**1. Turn on the Authorization Code flow**

Set **Authorization Code flow** to **On**.

<ul>
  <li>A warning reads **Authentication is off. To use this service for authentication or API access, activate at least one supported flow.** until a flow is enabled.</li>
  <li>Set **Require PKCE** to **Off** — StackOne's authorization-code flow does not send a PKCE code challenge, and Hub rejects the exchange with a `pkce_is_required` error if this stays on.</li>
</ul>

**2. Set the redirect URI**

In **Redirect URIs**, enter the **Callback URL** from your Connector Profile.

<ul>
  <li>Click **Save**.</li>
</ul>

![The Authentication tab with the Client ID field, the Authorization Code flow toggle, and the Redirect URIs field highlighted.](https://mintcdn.com/stackone-60/reQr1IRXGxtor6PF/connectors/jetbrains/images/oauth2-setup-authentication.png?fit=max\&auto=format\&n=reQr1IRXGxtor6PF\&q=85\&s=3bda05df1d512c0195b3d9082b42ec83)

## Copy the credentials

The service's **Client ID** and **Client secret** are the values StackOne needs.

**1. Copy the Client ID**

Copy the **Client ID** value shown on the **Authentication** tab across as the Client ID.

**2. Generate and copy the Client secret**

Click **Change …** next to **Client secret**, then **Generate** a new value.

<ul>
  <li>Click **Change Secret** to confirm and reveal the new secret.</li>
  <li>Copy the **New Secret** value across as the Client Secret before closing the dialog.</li>
  <li>The secret is only shown once and cannot be retrieved after you close the dialog.</li>
</ul>

![The Change service secret dialog with the generated secret hidden and the Change Secret button highlighted.](https://mintcdn.com/stackone-60/reQr1IRXGxtor6PF/connectors/jetbrains/images/oauth2-setup-client-secret.png?fit=max\&auto=format\&n=reQr1IRXGxtor6PF\&q=85\&s=14cf6e8796c6f84740b177b02cd89715)

## Find your YouTrack base URL

Your base URL identifies the YouTrack instance this Hub service belongs to — the same instance the Client ID and Client secret above were issued on. Copy the **YouTrack Base URL** across.

<ul>
  <li>Check your browser address bar when signed in to YouTrack.</li>
  <li>New cloud — if your URL is `https://acme.youtrack.cloud/issues`, your base URL is `https://acme.youtrack.cloud`</li>
  <li>Legacy cloud — if your URL is `https://acme.myjetbrains.com/youtrack/issues`, your base URL is `https://acme.myjetbrains.com/youtrack`</li>
  <li>Self-hosted — use your server URL, for example `https://youtrack.example.com`</li>
  <li>Enter the base URL without a trailing `/api` — StackOne appends it automatically.</li>
  <li>Format: `https://{your-org}.youtrack.cloud`</li>
  <li>Example: `https://acme.youtrack.cloud`</li>
</ul>

## Create the StackOne Connector Profile

**1. Create a Connector Profile**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

**2. Link an Account**

Once the Connector Profile is created, continue to [link an account](https://docs.stackone.com/connectors/jetbrains/guides/link-account/oauth-2-0.md).


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