Campaign Tools

Full campaign lifecycle management with delivery analytics.

campaign_list

List all campaigns with status and delivery stats. Parameters:

Parameter	Type	Required	Default	Description
`channelId`	string	No	—	Filter by channel ID
`status`	string	No	—	Filter by status: `draft`, `scheduled`, `active`, `paused`, `completed`
`page`	number	No	1	Page number
`limit`	number	No	10	Items per page

campaign_get

Get detailed campaign info including delivery breakdown by recipient status. Parameters:

Parameter	Type	Required	Description
`id`	string	Yes	Campaign ID

Response includes: all campaign fields plus a recipientBreakdown array showing counts by status.

campaign_create

Create a new campaign. Parameters:

Parameter	Type	Required	Default	Description
`channelId`	string	Yes	—	Channel ID
`name`	string	Yes	—	Campaign name
`description`	string	No	—	Campaign description
`campaignType`	enum	Yes	—	`contacts`, `csv`, or `api`
`type`	enum	Yes	—	`marketing` or `transactional`
`apiType`	enum	Yes	—	`cloud_api` or `mm_lite`
`templateId`	string	Yes	—	Template ID to use
`templateName`	string	Yes	—	Template name
`templateLanguage`	string	No	`"en_US"`	Template language
`contactGroups`	string[]	No	—	Target contact groups
`scheduledAt`	string	No	—	ISO datetime for scheduling
`status`	string	No	`"draft"`	Initial status
`dryRun`	boolean	No	`false`	Validate without creating

Example:

{
  "channelId": "ch_abc123",
  "name": "Flash Sale May 2026",
  "campaignType": "contacts",
  "type": "marketing",
  "apiType": "cloud_api",
  "templateId": "tpl_abc123",
  "templateName": "flash_sale",
  "contactGroups": ["customers", "vip"],
  "scheduledAt": "2026-05-10T09:00:00Z",
  "status": "scheduled"
}

campaign_update_status

Update campaign status to start, pause, resume, or complete a campaign. Parameters:

Parameter	Type	Required	Description
`id`	string	Yes	Campaign ID
`status`	enum	Yes	New status: `draft`, `scheduled`, `active`, `paused`, `completed`

campaign_delete

Delete a campaign. Parameters:

Parameter	Type	Required	Description
`id`	string	Yes	Campaign ID to delete

campaign_analytics

Get detailed delivery analytics for a campaign. Parameters:

Parameter	Type	Required	Description
`id`	string	Yes	Campaign ID

Response:

{
  "id": "camp_abc123",
  "name": "Flash Sale May 2026",
  "status": "completed",
  "recipientCount": 5000,
  "sentCount": 4950,
  "deliveredCount": 4800,
  "readCount": 3200,
  "repliedCount": 450,
  "failedCount": 150,
  "deliveryRate": "96.00%",
  "readRate": "64.65%",
  "failureRate": "3.00%"
}

Getting Started

Tools Reference

Resources

Campaign Tools

Campaign Tools

campaign_list

campaign_get

campaign_create

campaign_update_status

campaign_delete

campaign_analytics

​Campaign Tools

​campaign_list

​campaign_get

​campaign_create

​campaign_update_status

​campaign_delete

​campaign_analytics

Campaign Tools

campaign_list

campaign_get

campaign_create

campaign_update_status

campaign_delete

campaign_analytics