Create a User
Create a new user in your organization
POST
POST /v1/users
Create a User
Create a new user in your organization.Body Parameters
POST /v1/users
Returns
Returns the created user object with all specified properties and system-generated fields.Response
Create or Update (PUT)
UsePUT /v1/users instead of POST to perform an upsert. If a user with the same fullyQualifiedName already exists, it will be updated; otherwise, a new user is created. The request body is the same as POST.
PUT will not return a 409 conflict error if the entity already exists — it will update the existing entity instead. However, for certain fields (such as description, tags, owners, and custom properties), PUT preserves an already-populated value instead of overwriting it with an empty or omitted one — the exact behavior depends on the field and the calling user or bot’s permissions, not a blanket rule. See Entity Update Behavior for the full preserve/merge rules. Use PATCH to intentionally replace an existing value.Bulk Create or Update (PUT)
UsePUT /v1/users/bulk to create or update multiple users in a single request. The request body is an array of create request objects.