---
title: "Start Campaign"
method: POST
path: "/campaign/start"
tags: ["campaign"]
---

# Start Campaign

`POST /campaign/start`

Initiates a new campaign with the specified configuration.

## Headers

- `X-API-KEY` string, required

## Request body

- object
  - `agent_id` string, required — (Required) ID of the agent that will handle the calls.
  - `list_id` string, required — (Required) ID of the uploaded campaign contact list.
  - `from_numbers` string[], required — (Required) Array of phone numbers to use for outbound calls.

## Response `200`

Campaign started successfully.

- object
  - `status` string — Success message indicating campaign registration
  - `has_ongoing_calls` boolean — Whether the workspace has other ongoing calls

## Other responses

- `400` — Bad Request - Invalid input.
- `401` — Unauthorized - Invalid or missing authentication.
- `500` — Internal Server Error.

---

[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)