---
title: "Create a campaign"
method: POST
path: "/api/v1/workspaces/{workspace_id}/campaigns"
tags: ["📂 Campaigns"]
---

# Create a campaign

`POST /api/v1/workspaces/{workspace_id}/campaigns`

Create a new campaign (folder) in the specified workspace. Color must be one of color_1..color_20.

## Path parameters

- `workspace_id` string, required

## Request body

- object
  - `name` string, required
  - `color` 'color_1' | 'color_2' | 'color_3' | 'color_4' | 'color_5' | 'color_6' | 'color_7' | 'color_8' | 'color_9' | 'color_10' | 'color_11' | 'color_12' | 'color_13' | 'color_14' | 'color_15' | 'color_16' | 'color_17' | 'color_18' | 'color_19' | 'color_20', required

## Response `201`

Campaign created

- object
  - `status` boolean
  - `message` string
  - `data` object
    - `id` string
    - `_id` string — Deprecated alias for `id` — will be removed once clients migrate.
    - `name` string
    - `color` string

## Other responses

- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - No access to workspace
- `422` — Validation failed
- `429` — Too Many Requests - Rate limit exceeded

---

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