---
schema: rendered-html/v1
title: "Postman Collection for the YouTrack REST API | Developer Portal for YouTrack and Hub Documentation"
source_url: https://www.jetbrains.com/help/youtrack/devportal/youtrack-postman-collection.html
generated_at: 2026-06-11T15:21:21.049336+00:00
---

Feedback

Thanks for your feedback!

Was this page helpful?

YesNo

Developer Portal for YouTrack and Hub

- Developer Portal
- Apps
- MCP Tools
- YouTrack Workflows
- YouTrack Import Scripts
- YouTrack Form API
- [YouTrack REST API](jetbrains__com__help__youtrack__devportal__youtrack-rest-api.md)
- Get Started with REST API
- Log in to YouTrack
- REST API URL and Endpoints
- [OpenAPI Specification (OAS)](jetbrains__com__help__youtrack__devportal__youtrack-openapi-specification.md)
- Fields Syntax
- Query Syntax
- [Request Headers](jetbrains__com__help__youtrack__devportal__yt-api-headers.md)
- Custom Fields in REST API
- Pagination
- Users, Groups, and Access Management
- Hub REST API Endpoints Deprecated in YouTrack 2026.1
- [Postman Collection for the YouTrack REST API](youtrack-postman-collection.html)
- REST API Reference
- REST API Use Cases
- REST API Troubleshooting
- Color Indices List
- Hub REST API

1. [YouTrack REST API](jetbrains__com__help__youtrack__devportal__youtrack-rest-api.md)
2. Get Started with REST API
3. [Postman Collection for the YouTrack REST API](#0)

# Postman Collection for the YouTrack REST API﻿

Last modified: 07 May 2026

We have gathered a set of YouTrack REST API requests in a [YouTrack Postman collection](https://www.postman.com/youtrack-dev/workspace/youtrack/). This collection consists of predefined YouTrack REST API requests and examples for these requests.

Postman is a tool that helps you make REST API requests with minimum effort. With the YouTrack Postman collection, you can get quickly started with the YouTrack REST API and begin interacting with your YouTrack programmatically.

## Prerequisites﻿

Before you start making requests to YouTrack with Postman, do the following:

- Create a permanent token for your YouTrack account. You will need a token to make REST API requests to YouTrack.
- Create a free account at the [postman.com](https://www.postman.com/) website. You will need this account to fork the YouTrack collection to your workspace.

## Send API Requests with Postman﻿

> ### note
>
> Postman tool is available in web and desktop versions. This tutorial focuses on the web interface of Postman.

To send REST API requests with Postman, first, you need to fork the YouTrack collection to your personal workspace and set it up.

### To set up a collection fork in Postman:﻿

1. Log in to the [postman.com](https://www.postman.com/) website and follow the link to the [YouTrack Postman workspace](https://www.postman.com/youtrack-dev/workspace/youtrack/).

   [![YouTrack Postman workspace](https://crawler.prototype.prolicht.digital/l/VFhFxU)](https://resources.jetbrains.com/help/img/youtrack/postman-youtrack-workspace.png)
2. In the panel on the left, select View more actions > Create a fork.

   [![Create a fork of the YouTrack Postman collection](https://crawler.prototype.prolicht.digital/l/JMZlCb)](https://resources.jetbrains.com/help/img/youtrack/postman-youtrack-fork.png)
3. In the Fork collection dialog window, enter the label for your fork and select the workspace where you want to fork the collection.

   Check the Watch original collection box if you want to receive notifications about changes in the original collection.

   [![Create a fork of the YouTrack Postman collection](https://crawler.prototype.prolicht.digital/l/5Dme3p)](https://resources.jetbrains.com/help/img/youtrack/postman-youtrack-fork-dialog.png)
4. Click the Fork Collection button.

   - Your personal copy of the YouTrack Postman collection opens.[![Create a fork of the YouTrack Postman collection](https://crawler.prototype.prolicht.digital/l/OyLCNO)](https://resources.jetbrains.com/help/img/youtrack/postman-youtrack-forked-collection.png)
5. Switch to the Variables tab and update the values for the main collection variables. Update the values in the Current value column of the table. For more details on sharing and persisting variable values in Postman, see the [Postman reference](https://learning.postman.com/docs/sending-requests/variables/#sharing-and-persisting-data).

   | Variable | Value |
   | --- | --- |
   | `baseUrl` | Enter the Base REST API URL of your YouTrack service. For more info, see REST API URL and Endpoints. |
   | `token` | The permanent token for the user account that you use to log in to YouTrack. For more info on how to create a permanent token, see Create a Permanent Token. |

   These two variables are the minimum that you need to start making requests to the YouTrack REST API. Once you've set these two variables, you're ready to go and send your first request.

   For some requests, you're going to need additional IDs of YouTrack entities. Refer to the collection documentation and to the YouTrack REST API documentation to learn how to find these IDs.
6. Once you've updated the variables, click the Save button in the upper-right corner.

   [![Create a fork of the YouTrack Postman collection](https://crawler.prototype.prolicht.digital/l/vgR1up)](https://resources.jetbrains.com/help/img/youtrack/postman-youtrack-forked-collection-variables.png)
   - You have created and set up a personal copy of the YouTrack Postman collection.

Now that you have set up your personal collection copy, you're ready to make requests with Postman.

To make a request, locate it in the tree on the left, make sure that you have set all the variables needed for this request, and click the Send button.

[![The result of sending a request in Postman](https://resources.jetbrains.com/help/img/youtrack/postman-send-request.png "The result of sending a request in Postman")](https://resources.jetbrains.com/help/img/youtrack/postman-send-request.png)

Each request in the YouTrack Postman collection has one or several samples linked to it. Check these samples for more information about the request, required request body, the expected result, and other details.

To learn more about working with Postman collections, refer to the [Postman documentation](https://www.postman.com/collection/).

- [Postman Collection for the YouTrack REST API](/help/youtrack/devportal/youtrack-postman-collection.html)
- [Prerequisites](/help/youtrack/devportal/youtrack-postman-collection.html#prerequisites)
- [Send API Requests with Postman](/help/youtrack/devportal/youtrack-postman-collection.html#send-requests-with-postman)
- [To set up a collection fork in Postman:](/help/youtrack/devportal/youtrack-postman-collection.html#to-set-up-collection-fork)

Hub REST API Endpoints Deprecated in YouTrack 2026.1REST API Reference

- Privacy & Security
- Terms Of Use
- Trademarks
- Legal

Copyright © 2000–2026 JetBrains s.r.o.
