On this page

POST/campaigns/manual

Create an empty campaign (READY_TO_SEND) ready for import or POST /campaigns/:id/leads. No Maps search, no credits. Not idempotent — each call creates a new campaign.

0 credits. Rate class: campaign_control (default 20/min).

Request

POST /campaigns/manual
X-API-Key: sk_live_...
Content-Type: application/json
{ "name": "Imported restaurants" }
FieldRequiredNotes
nameYesNon-empty string

Unknown fields → 400.

Response

Campaign detail (same shape as GET /campaigns/:id) plus source: "manual".

Errors

validation_error · rate_limited · upstream_unavailable

MCP

Tool: create_manual_campaign.