---
title: "Create and launch a campaign; its flat price is charged from the balance at launch"
method: POST
path: "/campaigns"
---

# Create and launch a campaign; its flat price is charged from the balance at launch

`POST /campaigns`

## Request

- Base URL: `https://clearvoyance.ai/api/v1`
- URL: `https://clearvoyance.ai/api/v1/campaigns`
- Auth: HTTP bearer

## Request body

- union
  - object
    - `kind` 'open_link', required
    - `title` string
    - `description` string, nullable
    - `senderName` string, nullable
    - `questions` object[]
      - `text` string, required
    - `giftText` string, nullable
    - `expiresInDays` integer
    - `responseCap` integer
  - object
    - `kind` 'targeted', required
    - `title` string
    - `description` string, nullable
    - `senderName` string, nullable
    - `questions` object[]
      - `text` string, required
    - `giftText` string, nullable
    - `expiresInDays` integer
    - `cohortEmails` string[], required
    - `minPercent` integer

## Response `201`

The live campaign and its share link or invitation links

- Ok
  - `ok` unknown, required

## Other responses

- `default`: A refusal or error: `code` is stable and `message` says what to do next

---

[API](https://skmtc.dev/clearvoyance/apis/clearvoyance-agent-api.md) · [All operations](https://skmtc.dev/clearvoyance/apis/clearvoyance-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/clearvoyance/apis/clearvoyance-agent-api/revisions/98fa8d9aa58b?raw)