Sign in

v1

latestOpenAPI 3.0.02026-07-145658104.5 KB
User

Create a new user.

post/{tenantID}/users

Path parameters

tenantIDstring required

The tenant ID.

Query parameters

api-versionstring required

Client API version.

Request body

givenNamestring

The given name for the user.

immutableIdstring

This must be specified if you are using a federated domain for the user's userPrincipalName (UPN) property when creating a new user account. It is used to associate an on-premises Active Directory user account with their Azure AD user object.

surnamestring

The user's surname (family name or last name).

usageLocationstring

A two letter country code (ISO standard 3166). Required for users that will be assigned licenses due to legal requirement to check for availability of services in countries. Examples include: "US", "JP", and "GB".

userType'Member' | 'Guest'

A string value that can be used to classify user types in your directory, such as 'Member' and 'Guest'.

Response

Created. Indicates success. The new user is returned in the response body.

deletionTimestampstring date-time nullable

The time at which the directory object was deleted.

objectIdstring

The object ID.

objectTypestring required

The object type.