---
title: "Create Campaign"
method: POST
path: "/campaigns"
tags: ["campaigns"]
---

# Create Campaign

`POST /campaigns`

Create AND launch a campaign (NOSO AI only) — there is no draft state.

## Request body

- CreateCampaignRequest
  - `name` string, required
  - `campaign_user_id` string, nullable
  - `audience_build_id` string, nullable
  - `months` integer[]
  - `tag_ids` string[]
  - `tag_names` string[]
  - `service_name_contains` string, nullable
  - `goal` string, nullable
  - `agent_instructions` string, nullable
  - `max_rounds` integer
  - `round_interval_days` integer
  - `audience_limit` integer, nullable
  - `business_unit_id` string, nullable
  - `redirect_phone_number` string, nullable
  - `first_message_template` string, nullable
  - `customer_ids` string[]

## Response `200`

Successful Response

- CreateCampaignResponse
  - `campaign` CampaignSummary, required
    - `id` string, required
    - `name` string, required
    - `status` string, required
    - `campaign_topic` string
    - `goal_met_label` string
    - `goal_met_outcome` string
    - `first_message_template` string, nullable
    - `unique_customers` integer, required
    - `unique_locations` integer, required
    - `total_events` integer, required
    - `created_at` string, required
    - `updated_at` string, nullable
    - `owner_name` string
    - `total_sent` integer
    - `total_replied` integer
    - `total_goal_met` integer
    - `total_refused` integer
    - `total_no_response` integer
    - `action_required_count` integer
    - `pending_count` integer
    - `max_rounds` integer
    - `progress` integer
  - `total_customers` integer, required
  - `total_events` integer, required

## Other responses

- `404` — Not found
- `422` — Validation Error

## Changes

- **2026-09-02** `d96feef8e2ef` — 2 warning
  - removed the optional property `campaign/applied_filters` from the response with the `200` status
  - removed the optional property `campaign/batch_count` from the response with the `200` status

[Change history](https://skmtc.dev/noso/apis/crucible-backend-api/changes/campaigns/post.md)

---

[API](https://skmtc.dev/noso/apis/crucible-backend-api.md) · [All operations](https://skmtc.dev/noso/apis/crucible-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/noso/crucible-backend-api/revisions/d96feef8e2ef/schema)