Microsoft Entra ID icon

Microsoft Entra ID

Interact with Microsoft Entra ID API

Actions11

User → Create

AI-generated

Summary

Create a Microsoft Entra ID user by sending a POST request to Microsoft Graph’s /users endpoint. Set the required account status, display name, user principal name, mail nickname, and password; optionally add profile, contact, address, employment, and password settings.

Inputs

  • Account Enabled (required) — Whether the new account is enabled; defaults to true.
  • Display Name (required) — Name to display in the address book.
  • User Principal Name (required) — The user's UPN. The operation checks that it contains only the allowed characters: letters, numbers, apostrophe, period, hyphen, underscore, exclamation mark, hash, caret, tilde, and @.
  • Mail Nickname (required) — The user's mail alias.
  • Password (required) — Password sent as passwordProfile.password.
  • Additional Fields — Optional user attributes, including personal details, contact and address information, employment data, user type, password policies, and whether the user must change their password at next sign-in. Business Phone is sent as a one-item array; date fields are converted to UTC ISO strings, and password policies are comma-separated. About Me, Birthday, Interests, My Site, Past Projects, Responsibilities, Schools Attended, and Skills are applied in a separate PATCH request after creation; other selected attributes are also applied in a follow-up PATCH. If applying optional fields fails, the node attempts to delete the newly created user and then reports the error.

Output shape

A single item containing the created user record returned by Microsoft Graph.

The node merges successfully applied additional fields into the returned record. Microsoft Graph errors are surfaced as node errors; a conflict may indicate that the user already exists.

Links

Discussion