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

# Create campaign

`POST /api/v1/campaigns`

Creates a campaign draft, scheduled campaign, or immediate send when `sendNow` is true.

## Request body

- CreateCampaignRequest
  - `name` string, required
  - `goal` string, required
  - `subject` string, required
  - `html` string, required
  - `link` string, uri, required
  - `audienceType` 'all' | 'tags' | 'manual'
  - `audienceTags` string[]
  - `audienceContactIds` string[]
  - `sendNow` boolean
  - `scheduledAt` string, date-time
  - `personalizationMode` 'off' | 'lead_description_intro'

## Response `200`

Campaign created

- object
  - `campaign` Campaign
    - `id` string
    - `name` string
    - `type` 'one-time' | 'drip'
    - `status` 'draft' | 'scheduled' | 'sending' | 'sent' | 'stopped'
    - `subject` string
    - `scheduledAt` string, date-time, nullable
    - `sentAt` string, date-time, nullable
    - `createdAt` string, date-time
    - `updatedAt` string, date-time

## Other responses

- `400` — Validation error
- `403` — The workspace cannot perform this write action

---

[API](https://skmtc.net/nudgen-marketing/apis/nudgen-developer-api.md) · [All operations](https://skmtc.net/nudgen-marketing/apis/nudgen-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nudgen-marketing/nudgen-developer-api/versions/f90a364e1720/schema)