Developer Portal for YouTrack and Hub Help

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:

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

Step-by-Step

To add a user to a project team:

  1. 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.

  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 <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.

  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 <YouTrack_token>' \ --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" }
18 August 2026