---
title: "Create Outbound Run Api"
method: POST
path: "/outbound/voice-agents/{voice_agent_id}/outbound-run"
tags: ["outbound"]
---

# Create Outbound Run Api

`POST /outbound/voice-agents/{voice_agent_id}/outbound-run`

Create an outbound run to initiate calls.

Specify either:
- outbound_batch_ids: Call all items from these batches
- outbound_batch_item_ids: Call only these specific items

Run items are created with WAITING status.
Worker process will pick them up and initiate calls.

## Path parameters

- `voice_agent_id` string, uuid, required

## Request body

- OutboundRunCreateAPI — Request to create an outbound run.
  - `schedule` VoiceAgentOutboundRunSchedule — Scheduling parameters for outbound calls. Calls will only be made within this time window. All datetimes must be timezone-aware (UTC recommended).
    - `earliest_at` string, date-time, nullable
    - `latest_at` string, date-time, nullable
  - `outbound_batch_ids` string[], nullable
  - `outbound_batch_item_ids` string[], nullable
  - `filter_for_no_run_items` boolean

## Response `200`

Successful Response

- VoiceAgentOutboundRunRead
  - `id` string, uuid, required
  - `voice_agent_id` string, uuid, required
  - `integration_voice_agent_outbound_config_relation_id` string, uuid, nullable, required
  - `outbound_auto_retry_config_id` string, uuid, nullable, required

## Other responses

- `422` — Validation Error

## Changes

> 17 revisions in range; 1 not diffed.

- **2026-09-03** `d65b8fefae34` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Change history](https://skmtc.dev/getanana/apis/cleon-api/changes/outbound/voice-agents/:voice_agent_id/outbound-run/post.md)

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getanana/apis/cleon-api/revisions/94579f820778?raw)