CreateRoomRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/telnyx/json-schema/telnyx-create-room-request-schema.json",
  "title": "CreateRoomRequest",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/telnyx-rooms-api-openapi.yml#/components/schemas/CreateRoomRequest",
  "properties": {
    "enable_recording": {
      "default": false,
      "description": "Enable or disable recording for that room.",
      "type": "boolean"
    },
    "max_participants": {
      "default": 10,
      "description": "The maximum amount of participants allowed in a room. If new participants try to join after that limit is reached, their request will be rejected.",
      "maximum": 50,
      "minimum": 2,
      "type": "integer"
    },
    "unique_name": {
      "description": "The unique (within the Telnyx account scope) name of the room.",
      "type": "string"
    },
    "webhook_event_failover_url": {
      "default": "",
      "description": "The failover URL where webhooks related to this room will be sent if sending to the primary URL fails. Must include a scheme, such as 'https'.",
      "format": "uri",
      "type": "string"
    },
    "webhook_event_url": {
      "description": "The URL where webhooks related to this room will be sent. Must include a scheme, such as 'https'.",
      "format": "uri",
      "type": "string"
    },
    "webhook_timeout_secs": {
      "default": null,
      "description": "Specifies how many seconds to wait before timing out a webhook.",
      "maximum": 30,
      "minimum": 0,
      "type": "integer"
    }
  },
  "type": "object"
}