Add a User to a Project Team
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.
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:
Step-by-Step
To add a user to a project team:
Get the ID of the project whose team you want to update. For instructions, see Get a Project ID. This example uses the project ID
0-0.Get the entity ID of the target YouTrack user.
To do so, send
GETrequest to the/api/usersendpoint, and in thefieldsrequest parameter, listid,login, andnameto identify the user. If you know the login or name of the target user, you can specify it in thequeryparameter 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 <YouTrack_token>'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.
Add the user to the project's team.
To do so, you need to send a
POSTrequest to the following YouTrack REST API endpoint:<YouTrack_REST_API_URL>/admin/projects/{projectID}/team/ownUsersIn 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 <YouTrack_token>' \ --data-raw '{"id":"1-7"}'In this sample request, we also specify the
fieldsparameter 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" }