list_campaigns
Retrieve Mailchimp campaigns with details like id, status, subject, and send stats. Filter by status or send date to find specific campaigns.
Instructions
List campaigns with metadata, send stats, and filtering by status or date.
Use to browse campaigns and discover campaign IDs. Use get_campaign_details for full settings of a single campaign. Use get_campaign_report for post-send performance metrics. Use search_campaigns to find campaigns by keyword instead of browsing.
Args: count: Number of campaigns to return (1-1000, default 20). offset: Pagination offset. Use when total_items exceeds count. status: Filter by status. Valid values: 'save' (draft), 'paused', 'schedule', 'sending', 'sent'. Omit to return all statuses. since_send_time: Only return campaigns sent after this datetime. ISO 8601 format (e.g. '2025-01-01T00:00:00Z'). Only applies to sent campaigns.
Returns: JSON with total_items and campaigns array. Each campaign: id, type ('regular', 'plaintext', 'absplit', 'rss', 'variate'), status, title, subject_line, preview_text, send_time (ISO 8601 or null), emails_sent, list_id, list_name.
Example: list_campaigns(count=10, status="sent") -> {"total_items": 42, "campaigns": [{"id": "abc123", "status": "sent", ...}]}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | ||
| offset | No | ||
| status | No | ||
| account | No | ||
| since_send_time | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |