Create Cloud User

Create a cloud user in Office 365.

Input

Field Definition Type Required
User
On Premises Immutable Id

Property is used to associate an on-premises Active Directory user account to their Azure Active Directory user object.

If you're using a federated domain for the user's userPrincipalName (UPN) property, then you must specify this property as you create a user account in the Graph.

String FALSE
Account Enabled

true if the account is enabled; otherwise, false.

Boolean FALSE
Display Name

Name displayed in the address book for the user. This is usually the combination of the user's first name, middle initial, and family name.

String TRUE
Force Change Password Next Sign In

true if the user must change their password on the next login; otherwise false.

Boolean FALSE
Mail Nickname

Mail alias for the user.

This field must not contain a space.

String TRUE
Password

Password for the user. Required when a user is created. It can be updated, but the user will be required to change the password on the next login.

The password must satisfy the minimum requirements as specified by the user's passwordPolicies property. By default, a strong password is required.

String TRUE
User Principal Name

User principal name (UPN) of the user. The UPN is an Internet-style login name for the user based on the Internet standard RFC 822.

By convention, this should map to the user's email name. The general format is alias@domain, where the domain must be present in the tenant's collection of verified domains.

String TRUE
Age Group

Age group of the user. Allowed values: null, minor, notAdult, and adult.

String FALSE
Assigned Licenses

Licenses that are assigned to the user.

List of objects FALSE
Business Phones

Telephone numbers for the user.

Although this is a string collection, only one number can be set for this property.

List of text FALSE
City

City in which the user is located.

String FALSE
Company Name

Company name associated with the user.

String FALSE
Consent Provided For Minor

Indicates whether consent has been obtained for minors.

Allowed values: null, granted, denied, and notRequired.

String FALSE
Country

Country or region in which the user is located.

For example, US or UK.

String FALSE
Department

Name for the department in which the user works.

String FALSE
Employee Id

Employee identifier assigned to the user by the organization.

String FALSE
Fax Number

Fax number of the user.

String FALSE
Given Name

Given (first) name of the user.

String FALSE
Is Resource Account

true if the user is a resource account; otherwise, false.

null value should be considered false.

Boolean FALSE
Job Title

User's job title.

String FALSE
Mobile Phone

Primary cellular telephone number for the user.

String FALSE
Office Location

Office location in the user's place of business.

String FALSE
Other Mails

List of other email addresses for the user.

List of text FALSE
Password Policies

Specifies password policies for the user.

This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two may be specified together.

For example: DisablePasswordExpiration, DisableStrongPassword.

String FALSE
Force Change Password Next Sign In With MFA

If true, at the next sign-in, the user must perform a multifactor authentication (MFA) before being forced to change their password.

The behavior is identical to forceChangePasswordNextSignIn except that the user is required to first perform a multifactor authentication before password change.

After a password change, this property will be automatically reset to false. If not set, the default is false.

Boolean FALSE
Postal Code

The postal code for the user's postal address. The postal code is specific to the user's country or region.

In the United States of America, this attribute contains the ZIP code.

String FALSE
Preferred Data Location

Preferred data location for the user.

String FALSE
Preferred Language

Preferred language for the user. Should follow ISO 639-1 Code.

For example en-US.

String FALSE
Show In Address List

true if the Outlook global address list should contain this user, otherwise false.

If not set, this is treated as true. For users invited through the invitation manager, this property is set to false.

Boolean FALSE
State

State or province in the user's address.

String FALSE
Street Address

Street address of the user's place of business.

String FALSE
Surname

User's surname (family name or last name).

String FALSE
Usage Location (2 char)

Two letter country code (ISO standard 3166). Required when assigning licenses to users, due to legal requirement to check for availability of services in countries.

For examples include: US, JP, and GB.

String FALSE
User Type

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

String FALSE
On Premises Extension Attributes

Extension attributes 1–15 for the user.

The individual extension attributes are neither selectable nor filterable.

For an onPremisesSyncEnabled user, this set of properties is on-premises-sourced and is read-only.

For a cloud-only user (where onPremisesSyncEnabled is false), these properties may be set during creation or update.

String FALSE
Extension Attribute 1

First customizable extension attribute.

String FALSE
Extension Attribute 2

Second customizable extension attribute.

String FALSE
Extension Attribute 3

Third customizable extension attribute.

String FALSE
Extension Attribute 4

Fourth customizable extension attribute.

String FALSE
Extension Attribute 5

Fifth customizable extension attribute.

String FALSE
Extension Attribute 6

Sixth customizable extension attribute.

String FALSE
Extension Attribute 7

Seventh customizable extension attribute.

String FALSE
Extension Attribute 8

Eighth customizable extension attribute.

String FALSE
Extension Attribute 9

Ninth customizable extension attribute.

String FALSE
Extension Attribute 10

Tenth customizable extension attribute.

String FALSE
Extension Attribute 11

Eleventh customizable extension attribute.

String FALSE
Extension Attribute 12

Twelfth customizable extension attribute.

String FALSE
Extension Attribute 13

Thirteenth customizable extension attribute.

String FALSE
Extension Attribute 14

Fourteenth customizable extension attribute.

String FALSE
Extension Attribute 15

Fifteenth customizable extension attribute.

String FALSE

Output

Field Definition Type
User
Id

Unique identifier for the user.

String
Business Phones

Telephone numbers for the user.

Although this is a string collection, only one number can be set for this property.

List
Display Name

The name displayed in the address book for the user.

This is usually the combination of the user's first name, middle initial, and family name.

String
Given Name

Given (first) name of the user.

String
Job Title

User's job title.

String
Mail

SMTP address for the user.

For example, jeff@contoso.onmicrosoft.com.

String
Mobile Phone

Primary cellular telephone number for the user.

String
Office Location

Office location in the user's place of business.

String
Preferred Language

Preferred language for the user. Should follow ISO 639-1 Code.

For example en-US.

String
Surname

User's surname (family name or last name).

String
User Principal Name

Principal name (also known as Username or UPN) of the user. The UPN is an Internet-style login name for the user based on the Internet standard RFC 822.

By convention, this should map to the user's email name.

The general format is alias@domain, where the domain must be present in the tenant's collection of verified domains.

String

Related topics

Azure Active Directory connector

Workflow elements

Guidance for Azure Active Directory connector

Azure Active Directory Management API overview