> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-bradley-turek-pfilter-operators-reference.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Create User

> Creates a new user in Domo



## OpenAPI

````yaml /openapi/product/user-api.yaml post /users
openapi: 3.0.3
info:
  title: Domo Users API
  description: |
    API for managing Domo Users from outside of your Domo instance, such as:
    - Jupyter scripts
    - Code Engine Functions
    - Custom Java/Node/Python scripts
  version: 1.0.0
  contact:
    name: Domo Support
    url: https://www.domo.com
servers:
  - url: https://{instance}.domo.com
    description: Domo Identity API
    variables:
      instance:
        default: your-instance
        description: Your Domo instance name
security:
  - DeveloperToken: []
tags:
  - name: Users
    description: Operations for managing Domo users
paths:
  /users:
    post:
      tags:
        - Users API (Product)
      summary: Create User
      description: Creates a new user in Domo
      operationId: createUser
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateUserRequest'
            example:
              displayName: John Doe
              emailAddress: john.doe@example.com
              roleId: 1
      responses:
        '200':
          description: User created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/User'
        '400':
          description: Bad request - Invalid input parameters
        '401':
          description: Unauthorized - Invalid or missing authentication token
        '409':
          description: Conflict - User already exists
components:
  schemas:
    CreateUserRequest:
      type: object
      required:
        - displayName
        - emailAddress
        - roleId
      properties:
        displayName:
          type: string
          description: Display name of the user
          example: John Doe
        emailAddress:
          type: string
          format: email
          description: Email address of the user
          example: john.doe@example.com
        roleId:
          type: integer
          description: Role ID to assign to the user
          example: 1
    User:
      type: object
      properties:
        id:
          type: integer
          description: Unique identifier for the user
          example: 123456
        displayName:
          type: string
          description: Display name of the user
          example: John Doe
        userName:
          type: string
          description: Username of the user
          example: john.doe@example.com
        emailAddress:
          type: string
          format: email
          description: Email address of the user
          example: john.doe@example.com
        roleId:
          type: integer
          description: Role ID assigned to the user
          example: 1
        attributes:
          type: array
          items:
            $ref: '#/components/schemas/UserAttribute'
          description: Custom attributes associated with the user
    UserAttribute:
      type: object
      properties:
        key:
          type: string
          description: Attribute key
          example: department
        values:
          oneOf:
            - type: array
              items:
                type: string
            - type: array
              items:
                type: integer
          description: Attribute values (can be strings or numbers)
          example:
            - Engineering
            - Product
  securitySchemes:
    DeveloperToken:
      type: apiKey
      in: header
      name: X-DOMO-Developer-Token
      description: Domo Developer Token for authentication

````