---
schema: rendered-html/v1
title: "Add User to Project Team | Developer Portal for YouTrack and Hub Documentation"
source_url: https://www.jetbrains.com/help/youtrack/devportal/api-usecase-add-user-to-team.html
generated_at: 2026-06-11T15:00:50.949673+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
- Get Started with REST API
- REST API Reference
- [REST API Use Cases](jetbrains__com__help__youtrack__devportal__api-use-cases.md)
- Create an Issue
- Create an Issue and Set Custom Fields
- Get Issues List with All Values
- Get Value for an Issue Custom Field
- Add Value to a Set
- Update Issue Custom Fields
- Update a Text Field Value
- Clear Values of Custom Fields
- Apply Commands to Issues
- [Tag or Untag Issues](jetbrains__com__help__youtrack__devportal__api-usecase-add-remove-tags.md)
- Work with Issue Tags
- Attach Files to an Issue
- Delete an Issue Attachment
- Download an Issue Attachment
- Link Issues
- Get Issue History
- Get a Database Backup
- [Add User to Project Team](api-usecase-add-user-to-team.html)
- [REST API Troubleshooting](jetbrains__com__help__youtrack__devportal__api-troubleshooting.md)
- Color Indices List
- Hub REST API

1. YouTrack REST API
2. [REST API Use Cases](jetbrains__com__help__youtrack__devportal__api-use-cases.md)
3. [Add User to Project Team](#0)

# Add User to Project Team﻿

Last modified: 11 May 2026

## Use Case﻿

Add users to a project team using YouTrack REST API.

## Summary﻿

Starting with YouTrack 2026.1, you can add users to a project team with YouTrack REST API. Project teams are available as the `team` subresource of a project. Direct team members are managed with the `ownUsers` subresource.

> ### note
>
> In YouTrack versions earlier than 2026.1, project team operations were performed with Hub REST API. Starting with YouTrack 2026.1, Hub REST API endpoints for project teams are no longer available for YouTrack project teams. Do not use `/hub/api/rest/projects/{project_id}/team/users` to update YouTrack project teams. Use YouTrack REST API endpoints instead. For details, see Hub REST API Endpoints Deprecated in YouTrack 2026.1.

Before you add a user to a project team, you need to collect the following data:

- The entity ID or short name of the target project.
- The entity ID of the user that you want to add to the project team.

When you have all necessary entity IDs, you can add the user as a direct member of the target project team by sending a POST request to the following endpoint:

<YouTrack_REST_API_URL>/admin/projects/{projectID}/team/ownUsers

## Step-by-Step﻿

### To add a user to a project team:﻿

1. Get the entity ID of the target YouTrack project.

   To do so, send `GET` request to the `/api/admin/projects` endpoint, and in the `fields` request parameter, list `id`, `shortName`, and `name` to identify the project. If you know the shortName or name of the target project, you can specify it in the `query` parameter to narrow down the results returned from the server.

   For example:

   curl -L -X GET 'https://example.youtrack.cloud/api/admin/projects?fields=id,name,shortName&query=SP' \
   -H 'Accept: application/json' \
   -H 'Content-Type: application/json' \
   -H 'Authorization: Bearer perm:am9obi5kb2U=.UG9zdG1hbiBKb2huIERvZQ==.jJe0eYhhkV271j1lCpfknNYOEakNk7' \
   -H 'Cookie: JSESSIONID=node0me8f20cnn11hg7zes33twvmc630.node0'

   In response, server returned the following data:

   [
     {
       "shortName": "SP",
       "name": "Sample Project",
       "id": "0-0",
       "$type": "Project"
     }
   ]
2. Get the entity ID of the target YouTrack user.

   To do so, send `GET` request to the `/api/users` endpoint, and in the `fields` request parameter, list `id`, `login`, and `name` to identify the user. If you know the login or name of the target user, you can specify it in the `query` parameter to narrow down the results returned from the server.

   For example:

   curl -L -X GET 'https://example.youtrack.cloud/api/users?fields=id,name,login&query=Mad%20Max' \
   -H 'Accept: application/json' \
   -H 'Authorization: Bearer perm:am9obi5kb2U=.UG9zdG1hbiBKb2huIERvZQ==.jJe0eYhhkV271j1lCpfknNYOEakNk7' \
   -H 'Cookie: JSESSIONID=node0mvgm5m4rifm11cxhwzedm6azu621.node0'

   In response, server returned the following data:

   [
     {
       "login": "Mad_Max",
       "name": "Mad Max",
       "id": "1-7",
       "$type": "User"
     }
   ]

   Now that we have entity IDs for both target project and user, we can move to the last step.
3. Add the user to the project's team.

   To do so, you need to send a `POST` request to the following YouTrack REST API endpoint:

   <YouTrack_REST_API_URL>/admin/projects/{projectID}/team/ownUsers

   In the payload of the request, specify the user's entity `id`.

   For example:

   curl -L -X POST 'https://example.youtrack.cloud/api/admin/projects/0-0/team/ownUsers?fields=id,login,name' \
   -H 'Accept: application/json' \
   -H 'Content-Type: application/json' \
   -H 'Authorization: Bearer perm:am9obi5kb2U=.UG9zdG1hbiBKb2huIERvZQ==.jJe0eYhhkV271j1lCpfknNYOEakNk7' \
   --data-raw '{"id":"1-7"}'

   In this sample request, we also specify the `fields` parameter to confirm the details of the user that was added to the team.

   In response, server returned the following data:

   {
     "login": "Mad_Max",
     "name": "Mad Max",
     "id": "1-7",
     "$type": "User"
   }

> ### tip
>
> The `/team/users` subresource returns all users in the project team, including users who are included through groups. This subresource is read-only. To add a user group to a project team, use `<YouTrack_REST_API_URL>/admin/projects/{projectID}/team/groups`.

- [Add User to Project Team](/help/youtrack/devportal/api-usecase-add-user-to-team.html)
- [Use Case](/help/youtrack/devportal/api-usecase-add-user-to-team.html#usecase-intro)
- [Summary](/help/youtrack/devportal/api-usecase-add-user-to-team.html#summary)
- [Step-by-Step](/help/youtrack/devportal/api-usecase-add-user-to-team.html#step-by-step)

Get a Database Backup[REST API Troubleshooting](jetbrains__com__help__youtrack__devportal__api-troubleshooting.md)

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

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