Actions / Campaigns

Manage campaign

Full accessmanage_campaign

Runs one step of the campaign flow: update, plan, write posts, and the other campaign actions. Planning and writing use AI credits.

Needs the publish scope. Acts on live social accounts or cannot be undone.

Inputs

Input	Type	Required	Description
`campaignId`	integer	Yes
`action`	"update" \| "plan" \| "write_posts" \| "edit_brief" \| "regenerate_brief" \| "delete_brief" \| "schedule_posts" \| "unschedule_posts" \| "unschedule_all" \| "undo_plan" \| "archive" \| "delete"	Yes
`name`	string
`goal`	"awareness" \| "engagement" \| "traffic" \| "leads" \| "sales" \| "launch" \| "event"
`brief`	string
`offer`	string
`startDate`	string		YYYY-MM-DD
`cadence`	"daily" \| "every other day" \| "3x per week" \| "weekly"
`postCount`	integer
`count`	integer		plan: how many post ideas
`tone`	string
`replan`	boolean
`tweak`	string
`briefId`	integer
`briefIds`	integer[]		Up to 60.
`postIds`	integer[]		Up to 60.
`headline`	string
`hook`	string
`angle`	string
`cta`	string
`platform`	string
`publishDate`	string		ISO 8601 with offset

REST

curl https://chirpy.me/api/v1/manage_campaign \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"campaignId":123,"action":"update"}'

MCP

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "manage_campaign",
    "arguments": {
      "campaignId": 123,
      "action": "update"
    }
  }
}

MCP hints: readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true.