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

# Schedule Calls (Batch)

> Schedules multiple calls in a single request. Limited to 50 contacts per request.



## OpenAPI

````yaml openapi.json POST /v1/schedule-calls-batch
openapi: 3.0.3
info:
  title: telli API
  version: 1.0.0
  description: API documentation for telli's V1 endpoints
servers:
  - url: https://api.telli.com
security:
  - apiKey: []
paths:
  /v1/schedule-calls-batch:
    post:
      summary: Schedule Calls Batch
      description: >-
        Schedules multiple calls in a single request. Limited to 50 contacts per
        request.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - contacts
              properties:
                contacts:
                  type: array
                  items:
                    type: object
                    required:
                      - contact_id
                      - agent_id
                    properties:
                      contact_id:
                        type: string
                        format: uuid
                        description: >-
                          telli contact ID of the contact to schedule a call
                          with
                      agent_id:
                        type: string
                        description: Agent ID to use for the call
                      max_retry_days:
                        type: number
                        description: >-
                          Optional number of days to retry the call. Defaults to
                          the account's max retry days
                      override_from_number:
                        type: string
                        description: >-
                          Optional phone number to use as the caller ID. Must be
                          a valid E.164 number that belongs to the account
                      schedule:
                        type: object
                        nullable: true
                        properties:
                          at:
                            type: string
                            format: date-time
                            description: >-
                              ISO 8601 timestamp in UTC to schedule the call at
                              a specific time. Must be in the future (up to 90
                              days)
                            example: '2024-01-01T10:00:00.000Z'
                          ignore_dialing_window:
                            type: boolean
                            example: false
                            default: false
                            description: >-
                              Optional flag to bypass dialing window
                              restrictions for the scheduled call. When true,
                              calls at the scheduled time regardless of dialing
                              windows. When false or omitted, respects dialing
                              windows
                        required:
                          - at
                        description: >-
                          Optional schedule configuration. Use to schedule a
                          call at a specific time, and optionally to bypass
                          dialing window restrictions. Setting a schedule will
                          override any existing schedule for the contact and
                          agent.
                  description: >-
                    Array of contacts to schedule calls for. Maximum 50 contacts
                    per request.
      responses:
        '200':
          description: Calls scheduled successfully
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    contact_id:
                      type: string
                      format: uuid
                      description: >-
                        The telli contact ID (only present for successful
                        scheduling)
                    status:
                      type: string
                      enum:
                        - success
                        - error
                      description: Status of the call scheduling
                    loop_id:
                      type: string
                      format: uuid
                      description: >-
                        The call loop ID (only present for successful
                        scheduling)
                    error_message:
                      type: string
                      description: Error message (only present for failed scheduling)
                    error_code:
                      type: integer
                      description: Error code (only present for failed scheduling)
              example:
                - contact_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                  status: success
                  loop_id: b2c3d4e5-f6a7-8901-bcde-f12345678901
                - contact_id: c3d4e5f6-a7b8-9012-cdef-123456789012
                  status: success
                  loop_id: d4e5f6a7-b8c9-0123-defg-h23456789012
                - contact_id: e5f6a7b8-c9d0-1234-efgh-i34567890123
                  status: error
                  error_message: Contact not found
                  error_code: 400
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized - Invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '402':
          description: Payment Required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      properties:
        message:
          type: string
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: Authorization
      description: 'API key must be provided as: Bearer <api_key>'
      x-bearer-format: Bearer

````