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

# Create web call

> Creates a web call (current behavior).

## Notes

* It creates a CallData record and returns all information needed to connect a web client to LiveKit.


## OpenAPI

````yaml post /api/calls/create-web-call
openapi: 3.0.3
info:
  title: Zudu API
  description: >-
    Comprehensive REST API for LiveKit Backend - Call Management, Agent
    Configuration, and Real-time Communication Services
  version: 1.0.0
  contact:
    name: Zudu AI Team
    url: https://zudu.ai
    email: support@zudu.ai
  license:
    name: Proprietary
    url: https://zudu.ai/license
servers:
  - url: https://api.zudu.ai
    description: Production (Customer-facing)
security:
  - apiKey: []
    apiSecret: []
tags:
  - name: Agent Management
    description: Create and manage AI agents
  - name: Call Data Management
    description: Call records and history
  - name: Customer API Keys
    description: Manage API keys
  - name: Post-Call Webhooks
    description: Webhook configuration
  - name: phone-number-controller
    description: Phone numbers
  - name: batch-call-controller
    description: Batch calls
  - name: MCP Server Management
    description: MCP servers
  - name: Knowledge Base Management
    description: Knowledge bases
  - name: Call Analysis
    description: Call analysis
paths:
  /api/calls/create-web-call:
    post:
      tags:
        - Call Data Management
      operationId: createWebCall
      requestBody:
        content:
          application/json:
            schema:
              type: object
              description: Web call creation request body
              properties:
                agent_id:
                  type: string
                  description: Specific agent ID to use for the web call
                is_widget_call:
                  type: boolean
                  description: Whether this is a widget-based call
                metadata:
                  type: object
                  description: Additional metadata for the call
              required:
                - agent_id
            example:
              agent_id: agent-123
              metadata:
                customer_id: cust-001
                session_type: support
                priority: high
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiResponse'
              example:
                message: Web call created successfully
                status: success
                error: null
                data:
                  organization_id: org-789
                  call_type: web_call
                  call:
                    call_id: web_call_4a45e25e-57a3-427f-885c-0bd4d5bb111f
                    agent_id: agent-123
                    organization_id: org-789
                    call_status: ongoing
                    call_type: web_call
                    direction: inbound
                    start_timestamp: 1748451530513
                    transcript_object: []
                    transcript_with_tool_calls: []
                    events:
                      - timestamp: 1748451530656
                        event: Web call created via API
                        session_time: 0
                        data:
                          agent_id: agent-123
                          organization_id: org-789
                          room_name: room_d4725a2e-b7e9-42a2-9890-b0aa5b8cc7fa
                      - timestamp: 1748451530810
                        event: LiveKit token generated
                        session_time: 0
                        data:
                          token_generated: true
                          room_name: room_d4725a2e-b7e9-42a2-9890-b0aa5b8cc7fa
                    metadata:
                      customer_id: cust-001
                      session_type: support
                      priority: high
                      room_name: room_d4725a2e-b7e9-42a2-9890-b0aa5b8cc7fa
                      call_type: web_call
                      created_via: create-web-call-api
                    opt_out_sensitive_data_storage: false
                  web_call_info:
                    room_name: room_d4725a2e-b7e9-42a2-9890-b0aa5b8cc7fa
                    access_token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
                    call_status: ongoing
                    agent_id: agent-123
                  livekit_connection:
                    server_url: wss://communication.zudu.ai
                    token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
                    room_name: room_d4725a2e-b7e9-42a2-9890-b0aa5b8cc7fa
            '*/*':
              schema:
                $ref: '#/components/schemas/ApiResponseMapStringObject'
components:
  schemas:
    ApiResponse:
      type: object
      properties:
        message:
          type: string
        status:
          type: string
        error:
          type: string
        data:
          type: object
    ApiResponseMapStringObject:
      type: object
      properties:
        message:
          type: string
        status:
          type: string
        error:
          type: string
        data:
          type: object
          additionalProperties:
            type: object
  securitySchemes:
    apiKey:
      type: apiKey
      description: API Key for MCP server and external service authentication
      name: X-API-KEY
      in: header
    apiSecret:
      type: apiKey
      description: API Secret for MCP server and external service authentication
      name: X-API-SECRET
      in: header

````