---
title: "Create Batch Job"
method: POST
path: "/batch_dial_jobs"
---

# Create Batch Job

`POST /batch_dial_jobs`

## Request

- Base URL: `https://api.vogent.ai/api`
- URL: `https://api.vogent.ai/api/batch_dial_jobs`
- Auth: HTTP bearer

Creates a new batch dial job. You must start the job with the `/paused` endpoint for calls to begin.

## Request body

- CreateBatchDialJobInput
  - `callAgentId` string, required
  - `maxConcurrentDials` integer, required
  - `name` string, required
  - `fromPhoneNumberIds` string[]
  - `schedule` WeeklyScheduleInput
    - `days` DayScheduleInput[], required
      - `dayOfWeek` integer, required
      - `timeSlots` ScheduleTimeSlotInput[], required
        - `startTime` string, required
        - `endTime` string, required
    - `timezone` string, required
    - `disableSchedule` boolean
  - `rows` BatchDialSpecInput[], required
    - `toNumber` string, required
    - `inputs` object: Must be a string => string map.

## Response `200`

Successful operation

- BatchDialJob
  - `id` string, required
  - `maxConcurrentDials` integer, required
  - `name` string, required
  - `status` 'INIT' | 'ACTIVE' | 'PAUSED' | 'COMPLETE' | 'CANCELLED', required
  - `fromPhoneNumberIds` string[]
  - `schedule` WeeklySchedule
    - `days` DaySchedule[], required
      - `dayOfWeek` integer, required
      - `timeSlots` ScheduleTimeSlot[], required
        - `startTime` string, required
        - `endTime` string, required
    - `timezone` string, required
  - `callAgentId` string, required
  - `createdAt` string, date-time, required

## Other responses

- `400`: Invalid input
- `422`: Validation exception

---

[API](https://skmtc.dev/vogent/apis/vogent-openapi-3-0.md) - [All operations](https://skmtc.dev/vogent/apis/vogent-openapi-3-0/llms.txt) - [OpenAPI document](https://skmtc.dev/vogent/apis/vogent-openapi-3-0/revisions/a5966cc364ef?raw)