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

# Create room

> Create a new Noux room. Authenticate using Bearer token with your Noux API key.



## OpenAPI

````yaml /openapi.json post /api/v1/room/create
openapi: 3.0.0
info:
  title: Noux REST API
  version: 1.0.0
  description: This page contains the standard OpenAPI specification for the Noux REST API.
  contact:
    name: Noux Digital Oy
    url: https://nouxdigital.com/
servers:
  - url: https://api.noux.app
    description: Production API
  - url: http://localhost:4000
    description: Local development
security: []
paths:
  /api/v1/room/create:
    post:
      tags:
        - Rooms
      summary: Create room
      description: >-
        Create a new Noux room. Authenticate using Bearer token with your Noux
        API key.
      parameters:
        - schema:
            type: string
            description: Bearer token with Noux API key
          required: true
          description: Bearer token with Noux API key
          name: authorization
          in: header
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                externalId:
                  type: string
                  description: External ID (e.g., CRM deal ID)
                externalUrl:
                  type: string
                  format: uri
                  description: External URL (e.g., link to CRM deal)
                customerOrganizationName:
                  type: string
                  minLength: 1
                  description: Customer organization name
                customerDomain:
                  type: string
                  description: Customer domain
                ownerEmail:
                  type: string
                  format: email
                  description: Room owner email
                templateId:
                  type: string
                  description: ID of the template room to duplicate
                participants:
                  type: array
                  items:
                    type: object
                    properties:
                      email:
                        type: string
                        format: email
                      firstName:
                        type: string
                        maxLength: 100
                      lastName:
                        type: string
                        maxLength: 100
                      role:
                        type: string
                        enum:
                          - seller
                          - customer
                    required:
                      - email
                      - firstName
                      - lastName
                      - role
                  description: Deal participants
              required:
                - customerOrganizationName
      responses:
        '200':
          description: Room created successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  roomId:
                    type: string
                    description: The created room ID
                  editUrl:
                    type: string
                    format: uri
                    description: URL to edit the created room
                required:
                  - roomId
                  - editUrl
        '400':
          description: Bad request - invalid input
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: boolean
                    enum:
                      - true
                    description: Indicates this is an error response
                  code:
                    type: string
                    enum:
                      - PARSE_ERROR
                      - BAD_REQUEST
                      - INTERNAL_SERVER_ERROR
                      - NOT_IMPLEMENTED
                      - METHOD_NOT_SUPPORTED
                      - TIMEOUT
                      - CONFLICT
                      - PRECONDITION_FAILED
                      - PAYLOAD_TOO_LARGE
                      - UNPROCESSABLE_CONTENT
                      - TOO_MANY_REQUESTS
                      - CLIENT_CLOSED_REQUEST
                      - INVALID_INPUT
                      - UNAUTHORIZED
                      - NOT_FOUND
                      - FORBIDDEN
                      - INVALID_STATE
                      - SERVER_ERROR
                    description: Error code for programmatic handling
                  message:
                    type: string
                    description: Human-readable error message
                required:
                  - error
                  - code
                  - message
        '401':
          description: Unauthorized - invalid or missing API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: boolean
                    enum:
                      - true
                    description: Indicates this is an error response
                  code:
                    type: string
                    enum:
                      - PARSE_ERROR
                      - BAD_REQUEST
                      - INTERNAL_SERVER_ERROR
                      - NOT_IMPLEMENTED
                      - METHOD_NOT_SUPPORTED
                      - TIMEOUT
                      - CONFLICT
                      - PRECONDITION_FAILED
                      - PAYLOAD_TOO_LARGE
                      - UNPROCESSABLE_CONTENT
                      - TOO_MANY_REQUESTS
                      - CLIENT_CLOSED_REQUEST
                      - INVALID_INPUT
                      - UNAUTHORIZED
                      - NOT_FOUND
                      - FORBIDDEN
                      - INVALID_STATE
                      - SERVER_ERROR
                    description: Error code for programmatic handling
                  message:
                    type: string
                    description: Human-readable error message
                required:
                  - error
                  - code
                  - message
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: Noux API key from your integration settings

````