Skip to content

How to create a YouTrack token

To use the YouTrack connector in basebox, you need a permanent token from your YouTrack account. This page walks you through it in three easy steps.

Three steps

  1. Open your profile. In YouTrack, click your profile picture in the top right corner, then choose Profile.
  2. Open Account Security. In the profile page, switch to the Account Security tab.
  3. Create a new token. Click New token…, give the token a name (for example basebox), select the scopes you want basebox to access, and click Create.

Copy the token immediately — YouTrack will not show it again.

Creating a YouTrack permanent token

Use the token in basebox

  1. Open Admin → Connectors in basebox.
  2. Find YouTrack and paste the token into the Token field.
  3. Click Test connection to verify it works.
  4. Toggle the connector On.

Choosing scopes

Grant the smallest set of scopes that fits your use case:

  • Read-only assistant (recommended starting point): YouTrack: Read Issue, YouTrack: Read Project.
  • Assistant that can comment / update: additionally grant YouTrack: Update Issue, YouTrack: Create Issue, YouTrack: Update Issue Private Fields as needed.

You can always create a second token with broader scopes later and replace the one in basebox.

Revoking a token

If a token is ever leaked or no longer needed, revoke it from the same Account Security screen — find the token in the list and delete it. basebox will lose access immediately on the next request.