---
title: "Create a campaign"
method: POST
path: "/api/v1/campaigns"
tags: ["Campaigns"]
---

# Create a campaign

`POST /api/v1/campaigns`

## Request body

- CreateCampaignRequest
  - `name` string, required — Campaign name.
  - `type` 'inbound' | 'outbound', required — Campaign type. **inbound**: receives calls on a phone number. **outbound**: dials contacts from a contact list.
  - `bot_uid` string, required — UID of the bot that handles calls for this campaign.
  - `phone_number_id` integer — ID of the phone number to use. Required for inbound campaigns.
  - `contact_list_id` integer — ID of the contact list to dial. Required for outbound campaigns.
  - `daily_budget_usd` number — Maximum daily spend in USD for outbound campaigns.
  - `time_start` string, required — Start time for the campaign calling window (e.g. "09:00").
  - `time_end` string, required — End time for the campaign calling window (e.g. "17:00").
  - `timezone` string — IANA timezone for the calling window (e.g. "America/New_York"). Defaults to UTC if not specified.

## Response `201`

Campaign created

- CampaignResponse
  - `id` integer — Unique identifier.
  - `name` string — Campaign name.
  - `type` string — Campaign type (inbound or outbound).
  - `active` boolean — Whether the campaign is currently active.
  - `bot_id` integer — Internal bot ID.
  - `bot_uid` string — Bot UID for API reference.
  - `phone_number_id` integer — Associated phone number ID.
  - `contact_list_id` integer — Associated contact list ID.
  - `daily_budget_usd` number — Daily budget in USD.
  - `time_start` string — Calling window start time.
  - `time_end` string — Calling window end time.
  - `timezone` string — Calling window timezone.
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `400` — Validation error
- `404` — Bot or contact list not found

## Changes

- **2026-01-27** `0933f9b53326` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/openmicai/apis/openmic-v1-external-api/changes/api/v1/campaigns/post.md)

---

[API](https://skmtc.dev/openmicai/apis/openmic-v1-external-api.md) · [All operations](https://skmtc.dev/openmicai/apis/openmic-v1-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openmicai/openmic-v1-external-api/revisions/4ebeb626e684/schema)