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

# YouTrack Self-Hosted

> Instructions for integrating with YouTrack Self-Hosted.

## Supported Features

<Badge color="blue">Provisioning</Badge> <Badge color="blue">Account Deletion</Badge>

<Info>
  An administrator account is required to set up the integration.
</Info>

## Prerequisites

### How to Log In

Go to the [YouTrack login page](https://www.jetbrains.com/youtrack/), enter your email address and password, and log in.

<img src="https://mintcdn.com/moneyforwardi/nsfls_1kFmYtx8ta/images/integrations/6gicv4soc5/2026-01-05-175010.png?fit=max&auto=format&n=nsfls_1kFmYtx8ta&q=85&s=9ada62da9e461c22acc845eb26110f0d" alt="YouTrack login screen" width="433" height="508" data-path="images/integrations/6gicv4soc5/2026-01-05-175010.png" />

### How to Find the Base URL

Use the **Hub Service URL** as the Base URL.

The Hub Service URL is the URL of the **Hub service** that handles authentication and user management for YouTrack.

* First, confirm the **Primary YouTrack Service URL** — the URL you use to access YouTrack.

Example: `https://www.mycompany.com`

* Next, find the corresponding **Hub Service URL**.\
  The Hub Service URL typically contains `hub` in the URL.

Example: `https://www.mycompany.com/hub`, `https://hub.mycompany.com`

* Use the **Hub Service URL** you found as the **Base URL**.

<Info>
  Make sure the URL contains `hub`.
</Info>

### How to Obtain an API Key

Click the icon in the upper right corner of the screen, then click **Profile**.

From the **Account Security** tab, click **New token**.

Specify a **token name and scope**, then click **Create**.

Copy the generated **API key**.

<img src="https://mintcdn.com/moneyforwardi/nsfls_1kFmYtx8ta/images/integrations/6gicv4soc5/screenshot-2025-12-26-at-14-16-59.png?fit=max&auto=format&n=nsfls_1kFmYtx8ta&q=85&s=592637cae20138af01ff48d17a114889" alt="API key retrieval screen" width="1816" height="1258" data-path="images/integrations/6gicv4soc5/screenshot-2025-12-26-at-14-16-59.png" />

#### Notes on Scopes

In YouTrack instances using the built-in Hub service, scopes are divided as follows:

**YouTrack**

Permissions for basic YouTrack operations, including issues, tags, commands, agile boards, dashboards, and reports.

**YouTrack Administration**

Permissions for project management, user access management, and server configuration updates.

## Integration Setup

In the MoneyForward Admina integration screen, search for **YouTrack Self-Hosted**.

Enter an arbitrary **workspace name**, the **Base URL** and **API key** obtained in the previous steps, then click **Connect**.

<img src="https://mintcdn.com/moneyforwardi/nsfls_1kFmYtx8ta/images/integrations/6gicv4soc5/2026-01-07-145331.png?fit=max&auto=format&n=nsfls_1kFmYtx8ta&q=85&s=0e3320c30b611e01138b278e7b4c791a" alt="Integration setup screen" width="460" height="620" data-path="images/integrations/6gicv4soc5/2026-01-07-145331.png" />

Once the integration is successful, registered user information will appear in the account list.

If the setup does not complete successfully, go to the Status tab on the integration screen, click **Edit**.
Try connecting again.

If the issue persists, please contact us via chat.