Overview
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
- In YouTrack, select your avatar, navigate to Profile > Account Security, and create a permanent token with the YouTrack scope.
- Copy the token. YouTrack does not show it again after you close the dialog.
- In the Persona Dashboard, navigate to Integrations > Marketplace and select YouTrack.
- Click Add Credential and enter a nickname for the credential.
- 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
- Create a Workflow or open an existing one.
- Add an Action Step, then select Integrations.
- Select YouTrack and choose your saved credential.
- Choose an action and map data into its fields.
- 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 asTST-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 |