# YouTrack integration overview

> List YouTrack projects and find, create, retrieve, update, or delete issues from Persona Workflows.

Source: https://help.withpersona.com/articles/mOLQVNeGXuanIwlU6xmIyv/
Section: Marketplace and 3rd-Party Integrations > Productivity > YouTrack

## Overview

[YouTrack](https://www.jetbrains.com/youtrack/) is a project management and issue tracking platform from JetBrains. Persona's YouTrack integration lets Workflows list projects and find, create, retrieve, update, or delete issues in YouTrack Cloud or YouTrack Server.

## Integration features

The YouTrack integration supports six Workflow actions:

- **List projects**: Return the projects available to the connected user.
- **List issues**: Find issues with YouTrack search syntax and pagination.
- **Create issue**: Create an issue in a project.
- **Retrieve issue**: Return one issue by its database ID or readable ID.
- **Update issue**: Change an issue's summary, description, or custom fields.
- **Delete issue**: Delete an issue by its database ID or readable ID.

## Setting up the YouTrack integration

### Prerequisites

To connect YouTrack, you need:

- A YouTrack Cloud or YouTrack Server instance.
- A permanent token with the YouTrack scope.
- The base URL of your YouTrack instance.
- Permission to manage integrations in the Persona Dashboard.

### Adding a YouTrack credential

1.  In YouTrack, select your avatar, navigate to **Profile > Account Security**, and create a permanent token with the YouTrack scope.
2.  Copy the token. YouTrack does not show it again after you close the dialog.
3.  In the Persona Dashboard, navigate to **Integrations > Marketplace** and select **YouTrack**.
4.  Click **Add Credential** and enter a nickname for the credential.
5.  Enter the permanent token and your YouTrack base URL, then save the credential.

For YouTrack Cloud, use a domain such as `example.youtrack.cloud`. For a `myjetbrains.com` instance, include the `/youtrack` path. Do not append `/api`; Persona adds it to the base URL.

## Using YouTrack in a Workflow

1.  Create a Workflow or open an existing one.
2.  Add an **Action Step**, then select **Integrations**.
3.  Select **YouTrack** and choose your saved credential.
4.  Choose an action and map data into its fields.
5.  Save and publish the Workflow.

## YouTrack operations

### List projects

Return the projects available to the connected user.

**Optional fields**

- **Fields**: Project attributes to return.
- **Skip** and **top**: Pagination controls.

### List issues

Find YouTrack issues.

**Optional fields**

- **Query**: A YouTrack search expression.
- **Fields**: Issue attributes to return.
- **Skip** and **top**: Pagination controls.
- **Custom fields**: Limit the custom fields returned.

### Create issue

Create an issue in a YouTrack project.

**Required fields**

- **Summary**.
- **Project**: The project ID returned by **List projects**.

**Optional fields**

- **Description**.
- **Custom fields**.
- **Fields**: Issue attributes to return.
- **Draft ID**.
- **Mute update notifications**: Requires permission to apply commands silently.

### Retrieve issue

Return one YouTrack issue.

**Required field**

- **Issue ID**: A database ID, such as `2-24`, or a readable ID, such as `TST-5`.

**Optional field**

- **Fields**: Issue attributes to return.

### Update issue

Update an existing YouTrack issue.

**Required field**

- **Issue ID**.

**Optional fields**

- **Summary** and **description**.
- **Custom fields**.
- **Fields**: Issue attributes to return.
- **Mute update notifications**: Requires permission to apply commands silently.

### Delete issue

Delete one YouTrack issue.

**Required field**

- **Issue ID**.

**Optional field**

- **Fields**: Issue attributes to return.

## Plans Explained

### YouTrack Integration by plan

|                      | Startup Program | Essential Plan | Growth Plan | Enterprise Plan |
| -------------------- | --------------- | -------------- | ----------- | --------------- |
| YouTrack Integration | Not Available   | Not Available  | Limited     | Available       |

[Learn more about pricing and plans](https://withpersona.com/pricing?utm_source=product&utm_medium=referral&utm_audience=a&utm_campaign=cm_gen_ds_hc-plan-table).