---
title: "Start Large Campaign Calls (Beta)"
method: POST
path: "/campaign/make-call-async"
tags: ["campaign"]
---

# Start Large Campaign Calls (Beta)

`POST /campaign/make-call-async`

Beta endpoint for starting calls from a draft bulk list created by /campaign/upload-csv.

## Headers

- `X-API-KEY` string, required

## Request body

- object — **Exactly one of from_numbers or number_pool_id must be provided.** Sending both or neither results in a 422.
  - `bulk_list_id` string, required — Draft bulk list ID returned by /campaign/upload-csv.
  - `agent_id` string, required — Assistant ID used during upload.
  - `country_code` string, required — Phone number country code.
  - `campaign_start_time` string, required — Campaign start time in DD/MM/YYYY, HH:MM format.
  - `campaign_end_time` string, required — Campaign end time in DD/MM/YYYY, HH:MM format.
  - `from_numbers` string[], nullable — Explicit list of FromNumber UUIDs / phone numbers. **Provide exactly one of from_numbers or number_pool_id.**
  - `number_pool_id` string, nullable — Managed number pool ID (rotation, spam skipping, auto-purchase). **Provide exactly one of from_numbers or number_pool_id.**
  - `call_config` object, required
    - `call_retry_config` object
      - `retry_count` integer
      - `retry_busy` integer
      - `retry_not_picked` integer
      - `retry_failed` integer
    - `call_time` object
      - `call_start_time` string
      - `call_end_time` string
      - `timezone` string
      - `scheduled_at` string, nullable — ISO 8601 datetime for scheduled call (e.g. '2026-10-18T09:00:00'). Uses the timezone above.
  - `concurrency_percentage` integer
  - `callback_url` string, nullable
  - `email_completion_user_ids` string[], nullable

## Response `200`

Large campaign call creation accepted.

- object
  - `message` string
  - `bulk_list_id` string
  - `status` string

## Other responses

- `400` — Bad Request - Invalid input.
- `401` — Unauthorized - Invalid or missing authentication.

---

[API](https://skmtc.dev/ringg/apis/ringg-ai-api-documentation.md) · [All operations](https://skmtc.dev/ringg/apis/ringg-ai-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ringg/ringg-ai-api-documentation/revisions/00b614a7714c/schema)