On this page

POST/campaigns

Credits: 0
Rate limit: 30 / minute (shared control bucket)
Idempotency: Idempotency-Key → POST:/campaigns


Purpose

Create an empty manual campaign: status: READY_TO_SEND, source: 'manual', zero leads. Then assign an agent and add leads.


Request

POST /campaigns
X-API-Key: sk_live_...
Content-Type: application/json
Idempotency-Key: optional-uuid
{ "name": "Broker outreach" }

name required (max 80 after trim). Null/blank rejected.


Response 201

Campaign detail (GET /campaigns/:id).


MCP

Tool: create_manual_campaign — optional idempotencyKey.