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

# Create app user

> Creates an app user. Only available to operators with a whitelabel app.



## OpenAPI

````yaml /openapi/integration-api-v2/openapi.yaml post /v2/app-users
openapi: 3.0.0
info:
  title: Spirii API
  description: Spirii API
  version: 2.10.0
  contact: {}
servers:
  - url: https://api.spirii.com
security: []
tags: []
paths:
  /v2/app-users:
    post:
      tags:
        - App Users
        - App Users v2
      summary: Create app user
      description: Creates an app user. Only available to operators with a whitelabel app.
      operationId: createAppUser
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateAppUserDTO'
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateAppUserResponseDTO'
        '400':
          description: Bad Request. An explanation message will be provided.
        '401':
          description: >-
            Unauthorized. The requested operation cannot be performed with the
            current access permissions.
        '403':
          description: >-
            Forbidden. Access is restricted to operators with a whitelabel app,
            or the request is otherwise not permitted.
        '500':
          description: >-
            An unexpected error occurred on the server while processing the
            request.
      security:
        - Authorization: []
components:
  schemas:
    CreateAppUserDTO:
      type: object
      properties:
        firstName:
          type: string
          example: Steve
          maxLength: 50
        lastName:
          type: string
          example: Smith
          maxLength: 50
        email:
          type: string
          example: steve.smith@example.com
          maxLength: 255
        phoneNumber:
          type: string
          example: '+4512345678'
          maxLength: 16
        whitelabel:
          type: string
          example: Viggo
          default: spirii
          maxLength: 50
        customerId:
          type: integer
          description: CRM customer id to associate with this app user.
        operatorId:
          type: integer
        companyId:
          type: integer
      required:
        - firstName
        - lastName
        - email
    CreateAppUserResponseDTO:
      type: object
      properties:
        appUserId:
          type: integer
          description: The unique identifier of the created app user.
      required:
        - appUserId
  securitySchemes:
    Authorization:
      type: apiKey
      in: header
      name: Authorization
      description: '`Authorization: Bearer <SPIRII_API_KEY>`'

````