Skip to main content
You need a YouTrack account with the Update Self permission to create a permanent token. The token inherits the permissions of the account that creates it, so use an account whose access matches the data you want to sync.

​
Find your YouTrack base URL

Your base URL identifies your organization’s YouTrack instance. You will paste it into the YouTrack Base URL field in StackOne Hub.

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

​
Generate a permanent token

A permanent token authenticates REST API calls on behalf of your account without an OAuth flow. You will paste its value into the Permanent Token field in StackOne Hub.

1

Sign in to YouTrack

Sign in to your YouTrack account instance with your username and password.

  • Open your instance URL directly if you know it, for example https://acme.youtrack.cloud.
2

Open your profile

Open the user menu from the application sidebar.

  • Click your avatar at the bottom of the left sidebar.
  • Select Profile from the menu.
The user avatar menu open in the sidebar with the Profile option highlighted.
3

Open Account Security

On your profile page, open the security settings where permanent tokens are managed.

  • Open the Account Security tab.
  • Scroll to the Tokens section and click New token under Permanent Tokens.
The Account Security tab with the New token button highlighted in the Tokens section.
4

Create the token

Complete the New Permanent Token dialog.

  • In the Name field, enter a name such as StackOne.
  • Under Scope, select YouTrack (add YouTrack Administration only if you need admin-level actions).
  • Click Create.
The New Permanent Token dialog with the Name field, the Scope set to YouTrack, and the Create button highlighted.
5

Copy the token

YouTrack displays the token only once, so copy it immediately.

  • The dialog reads: Permanent token created. Copy it before you close this dialog and keep it in a secure location. This is the only time the token is visible.
  • The token is shown only once and cannot be retrieved after you close the dialog.
  • Click Copy token and store it securely for use later.
  • The token starts with the perm: prefix — include the full value, prefix and all.
The token-created dialog with the token value hidden and the Copy token button highlighted.

​
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:
  • YouTrack Base URL
  • Permanent Token
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.

​
Next Steps

Webhooks setup

Configure receiving Events for JetBrains YouTrack into StackOne.