> ## 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 phone call

> Creates a phone call and triggers outbound calling (current behavior).

## Notes

* It both creates the CallData record and initiates the outbound phone call (or schedules it).


## OpenAPI

````yaml post /api/calls/create-phone-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-phone-call:
    post:
      tags:
        - Call Data Management
      operationId: createPhoneCall
      requestBody:
        content:
          application/json:
            schema:
              type: object
              description: Phone call creation request body
              properties:
                from_number:
                  type: string
                  description: Source phone number for outbound call
                to_number:
                  type: string
                  description: Destination phone number to call
                override_agent_id:
                  type: string
                  description: Specific agent ID to use; auto-select if omitted
                scheduled_timestamp:
                  type: integer
                  description: Unix timestamp (seconds) for scheduled call execution
                metadata:
                  type: object
                  description: Additional metadata for the call
              required:
                - from_number
                - to_number
            example:
              from_number: '+14157774444'
              to_number: '+12137774445'
              override_agent_id: agent-123
              metadata:
                customer_id: cust-001
                campaign: summer-2024
                priority: high
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiResponse'
              example:
                message: Phone call created and initiated successfully
                status: success
                error: null
                data:
                  organization_id: org-789
                  call_type: phone_call
                  status: call_initiated
                  call:
                    call_id: phone_call_affba6e8-3e20-4037-a777-2a7e8c46e14f
                    agent_id: agent-123
                    organization_id: org-789
                    call_status: ongoing
                    call_type: phone_call
                    direction: outbound
                    from_number: '+14157774444'
                    to_number: '+12137774445'
                    start_timestamp: 1748451520138
                    transcript_object: []
                    transcript_with_tool_calls: []
                    events:
                      - timestamp: 1748451521217
                        event: Phone call created via API
                        session_time: 0
                        data:
                          to_number: '+12137774445'
                          agent_id: agent-123
                          from_number: '+14157774444'
                      - timestamp: 1748451522440
                        event: Outbound call initiated
                        session_time: 0
                        data:
                          livekit_room: call_4ef1e9cf-95e9-4408-a676-ced7fe8e5f93
                          dispatch_status: initiated
                    metadata:
                      customer_id: cust-001
                      campaign: summer-2024
                      priority: high
                      follow_up: quarterly_check
                    opt_out_sensitive_data_storage: false
                  phone_call_info:
                    from_number: '+14157774444'
                    to_number: '+12137774445'
                    direction: outbound
                    call_status: ongoing
            '*/*':
              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

````