400 Bad Request When Creating a User

This article examines an error that might occur when you create a user account using YouTrack REST API. You can face this error when the request is sent to an endpoint that doesn't support user creation in your YouTrack version.

Error Message

            {
                "error": "invalid_properties",
                "error_description": "<no user> is not a valid user login.",
                "error_children": [
                    {
                        "error": "User-is-invalid",
                        "error_description": "<no user> is not a valid user login.",
                        "error_developer_message": "<no user> is not a valid user login."
                    }
                ]
            }
        

Request Details

Here are the details about a sample request that might result in this error.

Attribute	Value
Request method	POST
Endpoint	`/api/users`
Request body	{ "login": "johny.doe", "email": "johny@doe.com", "fullName": "Johny Doe", "$type": "User" }
HTTP response code	400

Troubleshooting

Here are some possible causes and suggestions on how to overcome the error and create the user account.

Cause

The request uses a user-management endpoint that isn't supported for creating users in your YouTrack version.

Solution

Check which API supports user management in your YouTrack version, then send the request to the corresponding endpoint.

Starting with YouTrack 2026.1, use YouTrack REST API for user-management operations. In earlier versions, create and manage user accounts with Hub REST API.

For details about choosing the correct API for user, group, role, and permission operations, see Users, Groups, and Access Management.

12 August 2026