| 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
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 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 |
|---|
 |  | 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.
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
clawlink_call_tool --tool "mailchimp_get_lists_info" --params '{}'
clawlink_call_tool --tool "mailchimp_list_campaigns" --params '{}'
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
- Install the ClawLink plugin (see Install above).
- Pair the plugin with
clawlink_begin_pairing if it is not configured yet.
- Open https://claw-link.dev/dashboard?add=mailchimp and connect Mailchimp (requires an active Mailchimp account).
- Call
clawlink_list_integrations to verify the connection is active.
Connection Management
List Connections
clawlink_list_integrations
Response: Returns all connected integrations. Look for mailchimp in the list.
Verify Connection
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:
- Direct the user to https://claw-link.dev/dashboard?add=mailchimp
- After they confirm, call
clawlink_list_integrations to verify
- 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 |
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 |
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
clawlink_call_tool --tool "mailchimp_list_campaigns" \
--params '{}'
Create a list (audience)
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
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
clawlink_call_tool --tool "mailchimp_send_campaign" \
--params '{"campaign_id": "CAMPAIGN_ID"}'
Get campaign report
clawlink_call_tool --tool "mailchimp_get_reports_campaign_report" \
--params '{"campaign_id": "CAMPAIGN_ID"}'
Discovery Workflow
- Call
clawlink_list_integrations to confirm Mailchimp is connected.
- Call
clawlink_list_tools --integration mailchimp to see the live catalog.
- Treat the returned list as the source of truth. Do not guess or assume what tools exist.
- If the user describes a capability but the exact tool is unclear, call
clawlink_search_tools with a short query and integration mailchimp.
- 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 │
└─────────────────────────────────────────────────────────────┘
- For unfamiliar tools, ambiguous requests, or any write action, call
clawlink_describe_tool first.
- Use the returned guidance, schema,
whenToUse, askBefore, safeDefaults, examples, and followups to shape the call.
- Prefer read, list, search, and get operations before writes when that reduces ambiguity.
- For writes or anything marked as requiring confirmation, call
clawlink_preview_tool first.
- Execute with
clawlink_call_tool. Pass confirmation only after the preview matches the user's intent.
- 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
- Check that the ClawLink plugin is installed:
openclaw plugins list
- If the plugin is installed but tools are missing, tell the user to send
/new as a standalone message to reload the catalog.
- If a fresh chat does not help, run:
openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
openclaw gateway restart
- After restart, tell the user to send
/new again and retry.
Resources
Related Skills
Powered by ClawLink — an integration hub for OpenClaw
