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

# Configure Outbound Calling

> Configure outbound calling for an agent.

This allows you to:
- Set multiple outbound phone numbers (caller IDs)
- Define calling schedules with time windows
- Set daily call limits
- Configure timezone-aware calling hours
- Set concurrent call limits

# ============================================
# QUOTA ENFORCEMENT
# ============================================



## OpenAPI

````yaml https://api.mrassistant.ai/openapi.json post /outbound/agents/{agent_id}/outbound-config
openapi: 3.1.0
info:
  title: Backend - Multilingual Voice Agent System
  description: FastAPI backend for multilingual voice agents with tool use
  version: 1.0.0
servers: []
security: []
paths:
  /outbound/agents/{agent_id}/outbound-config:
    post:
      tags:
        - outbound-config
      summary: Configure Outbound Calling
      description: |-
        Configure outbound calling for an agent.

        This allows you to:
        - Set multiple outbound phone numbers (caller IDs)
        - Define calling schedules with time windows
        - Set daily call limits
        - Configure timezone-aware calling hours
        - Set concurrent call limits

        # ============================================
        # QUOTA ENFORCEMENT
        # ============================================
      operationId: >-
        configure_outbound_calling_outbound_agents__agent_id__outbound_config_post
      parameters:
        - name: agent_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Agent Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OutboundConfiguration'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OutboundConfigResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    OutboundConfiguration:
      properties:
        agent_id:
          type: string
          format: uuid
          title: Agent Id
        phone_numbers:
          items:
            $ref: '#/components/schemas/OutboundPhoneNumber'
          type: array
          minItems: 1
          title: Phone Numbers
        schedules:
          items:
            $ref: '#/components/schemas/CallingSchedule'
          type: array
          minItems: 1
          title: Schedules
        default_schedule_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Default Schedule Id
      type: object
      required:
        - agent_id
        - phone_numbers
        - schedules
      title: OutboundConfiguration
      description: Complete outbound calling configuration.
    OutboundConfigResponse:
      properties:
        agent_id:
          type: string
          title: Agent Id
        phone_numbers:
          items:
            $ref: '#/components/schemas/OutboundPhoneNumber'
          type: array
          title: Phone Numbers
        schedules:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Schedules
        default_schedule_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Default Schedule Id
        total_calls_today:
          type: integer
          title: Total Calls Today
        calls_remaining_today:
          type: integer
          title: Calls Remaining Today
        can_call_now:
          type: boolean
          title: Can Call Now
        next_available_time:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Available Time
      type: object
      required:
        - agent_id
        - phone_numbers
        - schedules
        - default_schedule_id
        - total_calls_today
        - calls_remaining_today
        - can_call_now
        - next_available_time
      title: OutboundConfigResponse
      description: Outbound configuration response.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    OutboundPhoneNumber:
      properties:
        phone_number:
          type: string
          pattern: ^\+?[1-9]\d{1,14}$
          title: Phone Number
          description: E.164 format
        display_name:
          anyOf:
            - type: string
              maxLength: 100
            - type: 'null'
          title: Display Name
        is_default:
          type: boolean
          title: Is Default
          description: Use as default caller ID
          default: false
        enabled:
          type: boolean
          title: Enabled
          default: true
        daily_limit:
          anyOf:
            - type: integer
              maximum: 10000
              minimum: 0
            - type: 'null'
          title: Daily Limit
          description: Max calls per day
        metadata:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Metadata
      type: object
      required:
        - phone_number
      title: OutboundPhoneNumber
      description: Outbound phone number configuration.
    CallingSchedule:
      properties:
        name:
          type: string
          maxLength: 100
          minLength: 1
          title: Name
        enabled:
          type: boolean
          title: Enabled
          default: true
        time_windows:
          items:
            $ref: '#/components/schemas/TimeWindow'
          type: array
          minItems: 1
          title: Time Windows
        max_concurrent_calls:
          type: integer
          maximum: 10
          minimum: 1
          title: Max Concurrent Calls
          default: 1
        call_interval_seconds:
          type: integer
          maximum: 3600
          minimum: 0
          title: Call Interval Seconds
          description: Minimum seconds between calls
          default: 0
        respect_dnc:
          type: boolean
          title: Respect Dnc
          description: Respect Do Not Call lists
          default: true
        respect_timezone:
          type: boolean
          title: Respect Timezone
          description: Respect recipient's timezone
          default: true
      type: object
      required:
        - name
        - time_windows
      title: CallingSchedule
      description: Calling schedule configuration.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    TimeWindow:
      properties:
        start_time:
          type: string
          pattern: ^([0-1]?[0-9]|2[0-3]):[0-5][0-9]$
          title: Start Time
          description: HH:MM format
        end_time:
          type: string
          pattern: ^([0-1]?[0-9]|2[0-3]):[0-5][0-9]$
          title: End Time
          description: HH:MM format
        timezone:
          type: string
          title: Timezone
          description: IANA timezone (e.g., America/New_York)
          default: UTC
        days_of_week:
          items:
            type: integer
          type: array
          maxItems: 7
          minItems: 1
          title: Days Of Week
          description: 0=Monday, 6=Sunday
      type: object
      required:
        - start_time
        - end_time
        - days_of_week
      title: TimeWindow
      description: Time window for calling.
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````