AZazure
User

POST /{tenantID}/users

Create a new user.

Request

  • Base URL
    https://graph.windows.net
  • Auth
    OAuth 2
    Implicithttps://login.microsoftonline.com/common/oauth2/authorize
    Scopesuser_impersonation

Path parameters

tenantIDstring required

The tenant ID.

Query parameters

api-versionstring required

Client API version.

Request body

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.

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

givenNamestring

The given name for the user.

surnamestring

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

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.

objectIdstring

The object ID.

objectTypestring required

The object type.

deletionTimestampstring date-time nullable

The time at which the directory object was deleted.

Changes

No recorded changes to this operation across all 17 revisions of this API.