> ## Documentation Index
> Fetch the complete documentation index at: https://docs.visotrust.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a user in your organization

> Creates a user in your organization. The email must belong to one of your organization's domains.

Optionally pass `businessUnit` with the name of an existing business unit (case-insensitive) to assign the
user to it; use `GET /api/v1/business-units` to list the available names. If omitted, the user is assigned
to the Unassigned business unit.



## OpenAPI

````yaml https://app.visotrust.com/v1/api-docs post /api/v1/users
openapi: 3.1.0
info:
  title: VISO TRUST API Documentation
  description: VISO TRUST
  version: v1.0
servers:
  - url: https://app.visotrust.com
    description: Generated server url
security: []
externalDocs:
  description: VISO TRUST Support Documentation
  url: https://docs.visotrust.com/
paths:
  /api/v1/users:
    post:
      tags:
        - client-api-user-rest-resource
      summary: Create a user in your organization
      description: >-
        Creates a user in your organization. The email must belong to one of
        your organization's domains.


        Optionally pass `businessUnit` with the name of an existing business
        unit (case-insensitive) to assign the

        user to it; use `GET /api/v1/business-units` to list the available
        names. If omitted, the user is assigned

        to the Unassigned business unit.
      operationId: createUser
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserCreateRequest'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/User'
components:
  schemas:
    UserCreateRequest:
      type: object
      properties:
        email:
          type: string
        firstName:
          type: string
        lastName:
          type: string
        businessUnit:
          type: string
          description: >-
            Name of the business unit to assign the user to (case-insensitive).
            Defaults to the Unassigned business unit when omitted.
          example: Engineering
          maxLength: 255
          minLength: 0
      required:
        - email
        - firstName
        - lastName
    User:
      type: object
      properties:
        id:
          type: integer
          format: int64
        status:
          type: string
          enum:
            - ACTIVE
            - INACTIVE
        firstName:
          type: string
        lastName:
          type: string
        email:
          type: string
        businessUnit:
          type: string

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.