Mailchimp

SKILL.md

---
name: mailchimp-marketing
description: Manage Mailchimp audiences, campaigns, automations, e-commerce, and analytics. Create and send email campaigns, manage subscribers, configure automations, handle e-commerce stores, and track performance with detailed reports.
---

# Mailchimp

![Mailchimp](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/brand-logos/mailchimp.svg?v=2)

Manage Mailchimp email marketing operations at scale. Handle audiences and subscribers, create and send campaigns, configure automations, manage e-commerce stores, and analyze performance with detailed reports.

This skill uses [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=mailchimp-marketing) for hosted connection flows and credentials so you do not need to configure Mailchimp API access yourself.

### Setup in 3 Steps

| Step 1: Install | Step 2: Pair Account | Step 3: Connect Mailchimp |
|:---:|:---:|:---:|
| ![Install](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/pairing/initialstep_1.gif) | ![Pair](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/approve_process.gif) | *App-specific connection GIF coming soon* |

## How It Works

```
┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   OpenClaw      │────▶│   ClawLink   │────▶│ Mailchimp API     │
│   (User Chat)   │     │   (OAuth)    │     │   (v3.0)        │
└─────────────────┘     └──────────────┘     └──────────────────┘
         │                       │                       │
         │  1. Install Plugin  │                       │
         │  2. Pair Device   │                       │
         │  3. Connect Mailchimp│                     │
         │                   │  4. Secure Token      │
         │                   │  5. Proxy Requests    │
         │                   │                       │
         ▼                   ▼                       ▼
   ┌──────────┐      ┌──────────┐           ┌──────────┐
   │  SKILL   │      │ Dashboard│           │ Mailchimp│
   │  File    │      │ Auth     │           │ Marketing│
   └──────────┘      └──────────┘           └──────────┘
```

## Install

Install the verified ClawLink plugin from ClawHub. After the user confirms, complete the full setup so ClawLink tools are visible in the next OpenClaw chat.

```bash
openclaw plugins install clawhub:clawlink-plugin
openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
openclaw gateway restart
```

Then tell the user: "OpenClaw has been restarted. Send `/new` as a standalone message to start a fresh chat, then ask for Mailchimp again."

## Quick Start

```bash
# Get lists (audiences)
clawlink_call_tool --tool "mailchimp_get_lists_info" --params '{}'

# List campaigns
clawlink_call_tool --tool "mailchimp_list_campaigns" --params '{}'

# Get account info
clawlink_call_tool --tool "mailchimp_get_account_info" --params '{}'
```

## Authentication

All Mailchimp tool calls are authenticated automatically by ClawLink using the user's connected Mailchimp account.

**No API key is required in chat.** ClawLink stores the OAuth token securely and injects it into every Mailchimp API request on the user's behalf.

### Getting Connected

1. Install the ClawLink plugin (see Install above).
2. Pair the plugin with `clawlink_begin_pairing` if it is not configured yet.
3. Open https://claw-link.dev/dashboard?add=mailchimp and connect Mailchimp (requires an active Mailchimp account).
4. Call `clawlink_list_integrations` to verify the connection is active.

## Connection Management

### List Connections

```bash
clawlink_list_integrations
```

**Response:** Returns all connected integrations. Look for `mailchimp` in the list.

### Verify Connection

```bash
clawlink_list_tools --integration mailchimp
```

**Response:** Returns the live tool catalog for Mailchimp.

### Reconnect

If Mailchimp tools are missing or the connection shows an error:

1. Direct the user to https://claw-link.dev/dashboard?add=mailchimp
2. After they confirm, call `clawlink_list_integrations` to verify
3. Then call `clawlink_list_tools --integration mailchimp`

## Security & Permissions

- Access is scoped to the connected Mailchimp account only.
- **All write operations require explicit user confirmation.** Before executing any campaign, list, or subscriber action, confirm the target resource and intended effect with the user.
- Destructive actions (delete list, delete campaign, archive subscriber) are marked as high-impact and must be confirmed.
- Free accounts are limited to 1 audience; paid plans allow multiple audiences.
- Webhook functionality requires Standard or Premium Mailchimp plan.
- Campaign cancellation requires Mailchimp Pro or Premium plan.

## Tool Reference

### Account & Configuration

| Tool | Description | Mode |
|------|-------------|------|
| `mailchimp_get_account_info` | Get account details, email, name, and plan type | Read |
| `mailchimp_get_lists_info` | Get all audiences/lists with basic info | Read |
| `mailchimp_add_connected_site` | Add a new connected site for tracking | Write |
| `mailchimp_add_domain_to_account` | Add a sending domain for email verification | Write |
| `mailchimp_verify_domain` | Verify domain ownership with confirmation code | Write |
| `mailchimp_add_export` | Create account data export (ZIP download) | Write |
| `mailchimp_get_account_export_info` | Check export status and get download URL | Read |

### Audiences (Lists)

| Tool | Description | Mode |
|------|-------------|------|
| `mailchimp_get_list_info` | Get detailed list/audience information by ID | Read |
| `mailchimp_add_list` | Create a new audience (name, contact info, permission reminder required) | Write |
| `mailchimp_update_list` | Update list settings and configuration | Write |
| `mailchimp_delete_list` | Permanently delete a list and all subscribers | Write |
| `mailchimp_get_list_members_info` | Get members of a list with pagination | Read |
| `mailchimp_add_list_member` | Add a new member to a list | Write |
| `mailchimp_add_or_update_list_member` | Add or update list member (upsert) | Write |
| `mailchimp_update_list_member` | Update member info and status | Write |
| `mailchimp_delete_list_member` | Permanently delete a list member | Write |
| `mailchimp_archive_list_member` | Archive (soft delete) a list member | Write |
| `mailchimp_get_member_info` | Get detailed member information | Read |
| `mailchimp_get_member_activity` | Get member activity history | Read |
| `mailchimp_get_member_goals` | Get member goal events | Read |
| `mailchimp_add_member_note` | Add a note to a list member | Write |
| `mailchimp_add_or_remove_member_tags` | Add or remove tags from a member | Write |
| `mailchimp_add_member_to_segment` | Add existing member to static segment | Write |
| `mailchimp_batch_add_or_remove_members` | Batch add/remove members from static segment | Write |
| `mailchimp_batch_subscribe_or_unsubscribe` | Batch subscribe or unsubscribe members | Write |

### Segments

| Tool | Description | Mode |
|------|-------------|------|
| `mailchimp_list_segments` | List all segments for a list | Read |
| `mailchimp_get_segment_info` | Get segment details by ID | Read |
| `mailchimp_create_segment` | Create a new segment (static or saved) | Write |
| `mailchimp_update_segment` | Update segment configuration | Write |
| `mailchimp_delete_segment` | Permanently delete a segment | Write |

### Tags

| Tool | Description | Mode |
|------|-------------|------|
| `mailchimp_get_list_tags` | Get all tags for a list | Read |
| `mailchimp_add_list_tag` | Create a new tag in a list | Write |
| `mailchimp_update_list_tag` | Update tag name | Write |
| `mailchimp_delete_list_tag` | Permanently delete a tag | Write |

### Merge Fields

| Tool | Description | Mode |
|------|-------------|------|
| `mailchimp_list_merge_fields` | List all merge fields for a list | Read |
| `mailchimp_add_merge_field` | Create a new merge field | Write |
| `mailchimp_update_merge_field` | Update merge field configuration | Write |
| `mailchimp_delete_merge_field` | Permanently delete a merge field | Write |

### Interest Categories & Groups

| Tool | Description | Mode |
|------|-------------|------|
| `mailchimp_list_interest_categories` | List interest categories for a list | Read |
| `mailchimp_add_interest_category` | Create a new interest category | Write |
| `mailchimp_list_interests` | List interests within a category | Read |
| `mailchimp_add_interest_in_category` | Add a new interest/group to a category | Write |

### Campaigns

| Tool | Description | Mode |
|------|-------------|------|
| `mailchimp_list_campaigns` | List all campaigns with filtering | Read |
| `mailchimp_get_campaign_info` | Get campaign details by ID | Read |
| `mailchimp_create_campaign` | Create a new campaign (regular, plaintext, or variate) | Write |
| `mailchimp_update_campaign` | Update campaign settings | Write |
| `mailchimp_delete_campaign` | Permanently delete a campaign | Write |
| `mailchimp_list_campaign_content` | Get campaign content and body | Read |
| `mailchimp_set_campaign_content` | Set campaign content (HTML, plain text) | Write |
| `mailchimp_send_campaign` | Send a campaign immediately | Write |
| `mailchimp_schedule_campaign` | Schedule a campaign for future sending | Write |
| `mailchimp_unschedule_campaign` | Remove campaign from schedule | Write |
| `mailchimp_pause_campaign` | Pause a running campaign | Write |
| `mailchimp_resume_campaign` | Resume a paused campaign | Write |
| `mailchimp_cancel_campaign` | Cancel a sending campaign (Pro/Premium only) | Write |

### Campaign Folders

| Tool | Description | Mode |
|------|-------------|------|
| `mailchimp_list_campaign_folders` | List all campaign folders | Read |
| `mailchimp_add_campaign_folder` | Create a new campaign folder | Write |
| `mailchimp_update_campaign_folder` | Update folder name | Write |
| `mailchimp_delete_campaign_folder` | Permanently delete a folder | Write |

### Campaign Feedback

| Tool | Description | Mode |
|------|-------------|------|
| `mailchimp_list_campaign_feedback` | List feedback comments on a campaign | Read |
| `mailchimp_add_campaign_feedback` | Post feedback comment on a campaign | Write |

### Automations

| Tool | Description | Mode |
|------|-------------|------|
| `mailchimp_list_automations` | List all classic automations | Read |
| `mailchimp_get_automation_info` | Get automation details by ID | Read |
| `mailchimp_add_automation` | Create classic abandoned cart automation | Write |
| `mailchimp_pause_automation` | Pause an automation | Write |
| `mailchimp_unpause_automation` | Resume a paused automation | Write |
| `mailchimp_archive_automation` | Permanently archive an automation | Write |
| `mailchimp_get_automation_email_subscriber` | Get automation email queue subscriber | Read |
| `mailchimp_add_automation_subscriber` | Add subscriber to automation email queue | Write |
| `mailchimp_remove_automation_subscriber` | Remove subscriber from automation queue | Write |

### Templates

| Tool | Description | Mode |
|------|-------------|------|
| `mailchimp_list_templates` | List all email templates | Read |
| `mailchimp_get_template_info` | Get template details by ID | Read |
| `mailchimp_add_template` | Create a new classic HTML template | Write |
| `mailchimp_update_template` | Update template content | Write |
| `mailchimp_delete_template` | Permanently delete a template | Write |
| `mailchimp_list_template_folders` | List template folders | Read |
| `mailchimp_add_template_folder` | Create a new template folder | Write |

### File Manager

| Tool | Description | Mode |
|------|-------------|------|
| `mailchimp_list_files` | List all files in file manager | Read |
| `mailchimp_add_file` | Upload file to file manager (base64, max 10MB) | Write |
| `mailchimp_update_file` | Update file info | Write |
| `mailchimp_delete_file` | Permanently delete a file | Write |
| `mailchimp_list_folders` | List file manager folders | Read |
| `mailchimp_add_folder` | Create a new file manager folder | Write |
| `mailchimp_update_folder` | Update folder name | Write |
| `mailchimp_delete_folder` | Permanently delete a folder | Write |

### Landing Pages

| Tool | Description | Mode |
|------|-------------|------|
| `mailchimp_list_landing_pages` | List all landing pages | Read |
| `mailchimp_get_landing_page` | Get landing page details by ID | Read |
| `mailchimp_add_landing_page` | Create a new landing page | Write |
| `mailchimp_publish_landing_page` | Publish a landing page | Write |

### Reports

| Tool | Description | Mode |
|------|-------------|------|
| `mailchimp_get_reports_campaign_report` | Get campaign performance report | Read |
| `mailchimp_get_reports_campaign_opens` | Get campaign open details | Read |
| `mailchimp_get_reports_campaign_CLICKS` | Get campaign click details | Read |
| `mailchimp_get_reports_campaign_UNSUBSCRIBES` | Get unsubscribes from campaign | Read |
| `mailchimp_get_reports_campaign_Bounces` | Get bounces from campaign | Read |
| `mailchimp_list_campaign_abuse_reports` | Get abuse complaints (spam reports) | Read |
| `mailchimp_campaign_abuse_report_details` | Get specific abuse report details | Read |
| `mailchimp_get_reports_campaign_LOCATION` | Get subscriber locations for campaign | Read |
| `mailchimp_get_reports_campaign_SETTINGS` | Get campaign settings report | Read |
| `mailchimp_get_reports_campaign_SENT_TO` | Get sent-to list for campaign | Read |
| `mailchimp_campaign_statistics_feedback` | Get advice based on campaign statistics | Read |
| `mailchimp_get_subcampaign_report` | Get report for A/B split sub-campaign | Read |

### E-Commerce

| Tool | Description | Mode |
|------|-------------|------|
| `mailchimp_list_ecommerce_stores` | List all connected e-commerce stores | Read |
| `mailchimp_add_store` | Add a new e-commerce store | Write |
| `mailchimp_get_ecommerce_store_info` | Get store details by ID | Read |
| `mailchimp_delete_ecommerce_store` | Permanently delete a store | Write |
| `mailchimp_list_ecommerce_customers` | List customers in a store | Read |
| `mailchimp_add_or_update_customer` | Add or update customer (upsert) | Write |
| `mailchimp_get_ecommerce_customer_info` | Get customer details | Read |
| `mailchimp_delete_ecommerce_customer` | Delete customer from store | Write |
| `mailchimp_list_ecommerce_products` | List products in a store | Read |
| `mailchimp_add_product` | Add a new product with variants | Write |
| `mailchimp_get_ecommerce_product_info` | Get product details | Read |
| `mailchimp_update_ecommerce_product` | Update product info | Write |
| `mailchimp_delete_ecommerce_product` | Delete product from store | Write |
| `mailchimp_add_product_image` | Add image to a product | Write |
| `mailchimp_list_ecommerce_product_variants` | List product variants | Read |
| `mailchimp_add_or_update_product_variant` | Add or update product variant | Write |
| `mailchimp_get_ecommerce_product_variant_info` | Get variant details | Read |
| `mailchimp_delete_ecommerce_product_variant` | Delete product variant | Write |
| `mailchimp_list_ecommerce_carts` | List carts in a store | Read |
| `mailchimp_add_cart` | Create a new cart | Write |
| `mailchimp_get_ecommerce_cart_info` | Get cart details | Read |
| `mailchimp_delete_ecommerce_cart` | Delete cart from store | Write |
| `mailchimp_add_cart_line_item` | Add line item to cart | Write |
| `mailchimp_update_cart_line_item` | Update cart line item | Write |
| `mailchimp_delete_cart_line_item` | Remove line item from cart | Write |
| `mailchimp_list_ecommerce_orders` | List orders in a store | Read |
| `mailchimp_add_order` | Create a new order | Write |
| `mailchimp_get_ecommerce_order_info` | Get order details | Read |
| `mailchimp_update_ecommerce_order` | Update order status | Write |
| `mailchimp_delete_ecommerce_order` | Delete order from store | Write |
| `mailchimp_add_order_line_item` | Add line item to existing order | Write |

### Promo Codes & Rules

| Tool | Description | Mode |
|------|-------------|------|
| `mailchimp_list_promo_rules` | List promo rules for a store | Read |
| `mailchimp_add_promo_rule` | Add a new promo rule | Write |
| `mailchimp_get_promo_rule_info` | Get promo rule details | Read |
| `mailchimp_update_promo_rule` | Update promo rule | Write |
| `mailchimp_delete_promo_rule` | Delete promo rule | Write |
| `mailchimp_list_promo_codes` | List promo codes for a rule | Read |
| `mailchimp_add_promo_code` | Add promo code to a rule | Write |
| `mailchimp_get_promo_code_info` | Get promo code details | Read |
| `mailchimp_update_promo_code` | Update promo code | Write |
| `mailchimp_delete_promo_code` | Delete promo code | Write |

### Events

| Tool | Description | Mode |
|------|-------------|------|
| `mailchimp_list_custom_events` | List available custom events | Read |
| `mailchimp_get_custom_event_template` | Get custom event template by name | Read |
| `mailchimp_create_custom_event` | Create custom event for a member | Write |

### Webhooks

| Tool | Description | Mode |
|------|-------------|------|
| `mailchimp_list_webhooks` | List webhooks for a list | Read |
| `mailchimp_add_webhook` | Create webhook for list events | Write |
| `mailchimp_update_webhook` | Update webhook configuration | Write |
| `mailchimp_delete_webhook` | Permanently delete webhook | Write |
| `mailchimp_add_batch_webhook` | Add batch webhook for batch request events | Write |

### Surveys

| Tool | Description | Mode |
|------|-------------|------|
| `mailchimp_list_surveys` | List surveys for a list | Read |
| `mailchimp_create_survey_campaign` | Create campaign linked to a survey | Write |

### Customer Journeys

| Tool | Description | Mode |
|------|-------------|------|
| `mailchimp_list_customer_journeys` | List customer journeys | Read |
| `mailchimp_get_customer_journey_info` | Get journey details by ID | Read |
| `mailchimp_customer_journeys_api_trigger_for_a_contact` | Trigger journey step for a contact | Write |

## Code Examples

### List campaigns

```bash
clawlink_call_tool --tool "mailchimp_list_campaigns" \
  --params '{}'
```

### Create a list (audience)

```bash
clawlink_call_tool --tool "mailchimp_add_list" \
  --params '{"name": "My New Audience", "contact": {"company": "My Company", "city": "New York", "country": "US"}, "permission_reminder": "You signed up for updates from us."}'
```

### Add a subscriber

```bash
clawlink_call_tool --tool "mailchimp_add_list_member" \
  --params '{"list_id": "LIST_ID", "email_address": "subscriber@example.com", "status": "subscribed", "merge_fields": {"FNAME": "John"}}'
```

### Send a campaign

```bash
clawlink_call_tool --tool "mailchimp_send_campaign" \
  --params '{"campaign_id": "CAMPAIGN_ID"}'
```

### Get campaign report

```bash
clawlink_call_tool --tool "mailchimp_get_reports_campaign_report" \
  --params '{"campaign_id": "CAMPAIGN_ID"}'
```

## Discovery Workflow

1. Call `clawlink_list_integrations` to confirm Mailchimp is connected.
2. Call `clawlink_list_tools --integration mailchimp` to see the live catalog.
3. Treat the returned list as the source of truth. Do not guess or assume what tools exist.
4. If the user describes a capability but the exact tool is unclear, call `clawlink_search_tools` with a short query and integration `mailchimp`.
5. If no Mailchimp tools appear, direct the user to https://claw-link.dev/dashboard?add=mailchimp.

## Execution Workflow

```
┌─────────────────────────────────────────────────────────────┐
│  READ OPERATIONS (Safe)                                     │
│  list → get → search → describe → call                      │
│                                                             │
│  Example: List campaigns → Get report → Show results         │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│  WRITE OPERATIONS (Require Confirmation)                     │
│  list → get → describe → preview → confirm → call          │
│                                                             │
│  Example: Preview campaign send → User approves → Send      │
└─────────────────────────────────────────────────────────────┘
```

1. For unfamiliar tools, ambiguous requests, or any write action, call `clawlink_describe_tool` first.
2. Use the returned guidance, schema, `whenToUse`, `askBefore`, `safeDefaults`, `examples`, and `followups` to shape the call.
3. Prefer read, list, search, and get operations before writes when that reduces ambiguity.
4. For writes or anything marked as requiring confirmation, call `clawlink_preview_tool` first.
5. Execute with `clawlink_call_tool`. Pass confirmation only after the preview matches the user's intent.
6. If the tool call fails, report the real error. Do not invent results or restate the failure as a missing capability unless the live catalog supports that conclusion.

## Notes

- Free Mailchimp accounts are limited to 1 audience. Paid plans allow multiple audiences.
- Campaign cancellation requires Mailchimp Pro or Premium plan.
- Webhook functionality requires Standard or Premium Mailchimp plan.
- Only one export can run at a time per account and only one per 24-hour period.
- Completed exports are available for 90 days.
- E-commerce stores require connected platform and Mailchimp store setup.
- Product variants require `inventory_quantity > 0` for product recommendations to work.
- Batch operations maximum 500 emails per request for each operation.
- Subscriber hash for upsert operations is MD5 hash of lowercase email address.

## Error Handling

| Status / Error | Meaning |
|----------------|---------|
| Tool not found | The tool name does not exist in the current catalog. Verify with `clawlink_list_tools --integration mailchimp`. |
| Missing connection | Mailchimp is not connected. Direct the user to https://claw-link.dev/dashboard?add=mailchimp. |
| Permission error | The account lacks required plan or permission for this operation. |
| List not found | The list ID does not exist. Verify with `mailchimp_get_lists_info`. |
| Campaign not found | The campaign ID does not exist. Verify with `mailchimp_list_campaigns`. |
| Write rejected | User did not confirm a write action. Always confirm before executing writes. |
| 402 Payment Required | Feature requires higher Mailchimp plan (Pro/Premium). |

### Troubleshooting: Tools Not Visible

1. Check that the ClawLink plugin is installed:
   ```bash
   openclaw plugins list
   ```
2. If the plugin is installed but tools are missing, tell the user to send `/new` as a standalone message to reload the catalog.
3. If a fresh chat does not help, run:
   ```bash
   openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
   openclaw gateway restart
   ```
4. After restart, tell the user to send `/new` again and retry.

## Resources

- [Mailchimp API Documentation](https://mailchimp.com/developer/marketing/api/)
- [Mailchimp Marketing API Guide](https://mailchimp.com/developer/marketing/docs/)
- ClawLink: https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=mailchimp-marketing
- ClawLink Docs: https://docs.claw-link.dev/openclaw
- ClawLink Verification: https://claw-link.dev/verify

## Related Skills

- [MailerLite Email Marketing](https://clawhub.ai/hith3sh/mailerlite-email-marketing) — For MailerLite campaigns and automation
- [Kit Email Marketing](https://clawhub.ai/hith3sh/kit-email-marketing) — For Kit email broadcasts
- [Instantly Campaigns](https://clawhub.ai/hith3sh/instantly-campaigns) — For Instantly cold email outreach

---

**Powered by [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=mailchimp-marketing)** — an integration hub for OpenClaw

![ClawLink Logo](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/logo/link_logo_black_small.png)