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

# Create a new campaign

`POST /campaigns`

Creates a campaign as a draft. To send it, use the send endpoint or provide scheduled_at.
Subject lines cannot start with "RE:" or "FWD:".
At least one list is required if scheduled_at is provided.

## Request body

- object
  - `title` string, required
  - `subject` string, required
  - `preview_text` string, nullable — Inbox preview snippet shown beneath the subject line. Optional.
  - `html` string, required — Email body HTML content
  - `from_name` string, required
  - `from_email` string, email, required
  - `scheduled_at` string, date-time — Schedule send time (omit for draft). Must include at least one list.
  - `lists` integer[] — Array of list IDs to send to
  - `excluded_lists` integer[] — List IDs whose contacts should be excluded from the send. Exclusion wins over inclusion.
  - `to_contact_tags` integer[] — Tag IDs whose contacts should receive the campaign. Can be combined with lists.
  - `excluded_contact_tags` integer[] — Tag IDs whose contacts should be excluded from the send. Exclusion wins over inclusion.

## Response `201`

Campaign created successfully

- Campaign
  - `id` integer
  - `title` string, required
  - `subject` string, required
  - `preview_text` string, nullable — Inbox preview snippet shown beneath the subject line in most email clients.
  - `html` string, required
  - `from_name` string, required
  - `from_email` string, email, required
  - `scheduled_at` string, date-time, nullable
  - `sent_at` string, date-time, nullable
  - `timezone` string
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `403` — Forbidden (not subscribed or cannot schedule)
- `422` — Validation error or configuration required (e.g., timezone not set)

---

[API](https://skmtc.net/sendfox/apis/sendfox-api.md) · [All operations](https://skmtc.net/sendfox/apis/sendfox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sendfox/sendfox-api/revisions/c5728da3037f/schema)