# createUser

**Type:** GraphQL mutations

**Description:**
Create a User

## Arguments
- input (CreateUserInput, Not Null): undefined
  - accountRoles (UserAccountRoleInput, Not Null): List of account associated with user.
Set user's account and list of the user's roles. User name and roles are required if the user can log in.
    - accountName (String): Account Name [unique identifier of Account - short name] which needs to be linked to User.
Example: "123456"
    - expiryDate (String): Expiry date of the user in YYYY-MM-DD format.
Expiry date should be provided when portalLogin flag is true. It is the date when user is no longer linked to the account.
If included, the value cannot be null. If not included, the user's access to the account will not expire.
Example: "2025-12-30"
    - roles (String): List of roles.
Example: ["USER", "ADMIN"]
  - attributes (AttributeInput): List of user custom attributes. Note that mandatory custom attributes must be included in this list
    - name (String): Name of the custom attribute.
Example: "REGION"
    - value (JSON): Value assigned to the custom attribute. Format and example depend on the type:
- Single Text: "EMEA"
- Multi-valued text: provide list of values between brackets [] delimited by , (e.g. ["Text1", "Text2"])
- Date: "YYYY/MM/DD" (e.g. "2025/12/31")
- Number: 12345
  - city (String): City portion of address.
Example: "New York"
  - country (String): Two-letter country code.
Example: "US"
  - displayName (String): Display name of the user.
Example: "John Doe"
  - emailAddress (String): Email address of the user.
Example: "johndoe@xyz.com"
  - faxNumber (String): User's fax number.
Example: "01154785"
  - firstName (String): First Name of the user.
Example: "John"
  - lastName (String): Last Name of the user.
Example: "Doe"
  - locale (String): User's locale.
Example: "en_US"
  - optIn (Boolean): Whether the User should opt to receive email notifications.
Example: false
  - phoneNumber (String): User's phone number.
Example: "989915487"
  - portalLogin (Boolean): Indicates whether created user can login to portal or not.
If portalLogin is false, the user is treated as a contact.
Example: true
  - shared (Boolean): Is this a shared login among several users?
Example: false
  - state (String): State portion of address.
Example: "The Empire State"
  - status (String): Flag to indicate if the user should be Active or Inactive.
Status can be one of the following values: Active, Inactive.
Example: "Active"
  - street (String): Street portion of address.
Example: "High Street"
  - timezone (String): Provide time zone setting in the format: GMT#.#DST#.
When a user is saved, this offset is converted to a time zone string and the time zone string is displayed when a user is retrieved.
Example: "GMT-6.0DST0"
  - userName (String): Important: The user name must match the email address for the user.
If portalLogin is set to false, this field is ignored. If portalLogin is set to true, this field is required.
Example: "johndoe@xyz.com"
  - zipcode (String): Postal code of address.
Example: "10118"

## Response
**Type:** UserCreationResponse
**Description:**
Response returned after attempting to create a user

### Fields
- message (String): User creation success message
- status (String): Status of the user created