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: InstallStep 2: Pair AccountStep 3: Connect MailchimpApp-specific connection GIF coming soon

How It Works#

text

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   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#

ToolDescriptionModemailchimp_get_account_infoGet account details, email, name, and plan typeReadmailchimp_get_lists_infoGet all audiences/lists with basic infoReadmailchimp_add_connected_siteAdd a new connected site for trackingWritemailchimp_add_domain_to_accountAdd a sending domain for email verificationWritemailchimp_verify_domainVerify domain ownership with confirmation codeWritemailchimp_add_exportCreate account data export (ZIP download)Writemailchimp_get_account_export_infoCheck export status and get download URLRead

Audiences (Lists)#

ToolDescriptionModemailchimp_get_list_infoGet detailed list/audience information by IDReadmailchimp_add_listCreate a new audience (name, contact info, permission reminder required)Writemailchimp_update_listUpdate list settings and configurationWritemailchimp_delete_listPermanently delete a list and all subscribersWritemailchimp_get_list_members_infoGet members of a list with paginationReadmailchimp_add_list_memberAdd a new member to a listWritemailchimp_add_or_update_list_memberAdd or update list member (upsert)Writemailchimp_update_list_memberUpdate member info and statusWritemailchimp_delete_list_memberPermanently delete a list memberWritemailchimp_archive_list_memberArchive (soft delete) a list memberWritemailchimp_get_member_infoGet detailed member informationReadmailchimp_get_member_activityGet member activity historyReadmailchimp_get_member_goalsGet member goal eventsReadmailchimp_add_member_noteAdd a note to a list memberWritemailchimp_add_or_remove_member_tagsAdd or remove tags from a memberWritemailchimp_add_member_to_segmentAdd existing member to static segmentWritemailchimp_batch_add_or_remove_membersBatch add/remove members from static segmentWritemailchimp_batch_subscribe_or_unsubscribeBatch subscribe or unsubscribe membersWrite

Segments#

ToolDescriptionModemailchimp_list_segmentsList all segments for a listReadmailchimp_get_segment_infoGet segment details by IDReadmailchimp_create_segmentCreate a new segment (static or saved)Writemailchimp_update_segmentUpdate segment configurationWritemailchimp_delete_segmentPermanently delete a segmentWrite

Tags#

ToolDescriptionModemailchimp_get_list_tagsGet all tags for a listReadmailchimp_add_list_tagCreate a new tag in a listWritemailchimp_update_list_tagUpdate tag nameWritemailchimp_delete_list_tagPermanently delete a tagWrite

Merge Fields#

ToolDescriptionModemailchimp_list_merge_fieldsList all merge fields for a listReadmailchimp_add_merge_fieldCreate a new merge fieldWritemailchimp_update_merge_fieldUpdate merge field configurationWritemailchimp_delete_merge_fieldPermanently delete a merge fieldWrite

Interest Categories & Groups#

ToolDescriptionModemailchimp_list_interest_categoriesList interest categories for a listReadmailchimp_add_interest_categoryCreate a new interest categoryWritemailchimp_list_interestsList interests within a categoryReadmailchimp_add_interest_in_categoryAdd a new interest/group to a categoryWrite

Campaigns#

ToolDescriptionModemailchimp_list_campaignsList all campaigns with filteringReadmailchimp_get_campaign_infoGet campaign details by IDReadmailchimp_create_campaignCreate a new campaign (regular, plaintext, or variate)Writemailchimp_update_campaignUpdate campaign settingsWritemailchimp_delete_campaignPermanently delete a campaignWritemailchimp_list_campaign_contentGet campaign content and bodyReadmailchimp_set_campaign_contentSet campaign content (HTML, plain text)Writemailchimp_send_campaignSend a campaign immediatelyWritemailchimp_schedule_campaignSchedule a campaign for future sendingWritemailchimp_unschedule_campaignRemove campaign from scheduleWritemailchimp_pause_campaignPause a running campaignWritemailchimp_resume_campaignResume a paused campaignWritemailchimp_cancel_campaignCancel a sending campaign (Pro/Premium only)Write

Campaign Folders#

ToolDescriptionModemailchimp_list_campaign_foldersList all campaign foldersReadmailchimp_add_campaign_folderCreate a new campaign folderWritemailchimp_update_campaign_folderUpdate folder nameWritemailchimp_delete_campaign_folderPermanently delete a folderWrite

Campaign Feedback#

ToolDescriptionModemailchimp_list_campaign_feedbackList feedback comments on a campaignReadmailchimp_add_campaign_feedbackPost feedback comment on a campaignWrite

Automations#

ToolDescriptionModemailchimp_list_automationsList all classic automationsReadmailchimp_get_automation_infoGet automation details by IDReadmailchimp_add_automationCreate classic abandoned cart automationWritemailchimp_pause_automationPause an automationWritemailchimp_unpause_automationResume a paused automationWritemailchimp_archive_automationPermanently archive an automationWritemailchimp_get_automation_email_subscriberGet automation email queue subscriberReadmailchimp_add_automation_subscriberAdd subscriber to automation email queueWritemailchimp_remove_automation_subscriberRemove subscriber from automation queueWrite

Templates#

ToolDescriptionModemailchimp_list_templatesList all email templatesReadmailchimp_get_template_infoGet template details by IDReadmailchimp_add_templateCreate a new classic HTML templateWritemailchimp_update_templateUpdate template contentWritemailchimp_delete_templatePermanently delete a templateWritemailchimp_list_template_foldersList template foldersReadmailchimp_add_template_folderCreate a new template folderWrite

File Manager#

ToolDescriptionModemailchimp_list_filesList all files in file managerReadmailchimp_add_fileUpload file to file manager (base64, max 10MB)Writemailchimp_update_fileUpdate file infoWritemailchimp_delete_filePermanently delete a fileWritemailchimp_list_foldersList file manager foldersReadmailchimp_add_folderCreate a new file manager folderWritemailchimp_update_folderUpdate folder nameWritemailchimp_delete_folderPermanently delete a folderWrite

Landing Pages#

ToolDescriptionModemailchimp_list_landing_pagesList all landing pagesReadmailchimp_get_landing_pageGet landing page details by IDReadmailchimp_add_landing_pageCreate a new landing pageWritemailchimp_publish_landing_pagePublish a landing pageWrite

Reports#

ToolDescriptionModemailchimp_get_reports_campaign_reportGet campaign performance reportReadmailchimp_get_reports_campaign_opensGet campaign open detailsReadmailchimp_get_reports_campaign_CLICKSGet campaign click detailsReadmailchimp_get_reports_campaign_UNSUBSCRIBESGet unsubscribes from campaignReadmailchimp_get_reports_campaign_BouncesGet bounces from campaignReadmailchimp_list_campaign_abuse_reportsGet abuse complaints (spam reports)Readmailchimp_campaign_abuse_report_detailsGet specific abuse report detailsReadmailchimp_get_reports_campaign_LOCATIONGet subscriber locations for campaignReadmailchimp_get_reports_campaign_SETTINGSGet campaign settings reportReadmailchimp_get_reports_campaign_SENT_TOGet sent-to list for campaignReadmailchimp_campaign_statistics_feedbackGet advice based on campaign statisticsReadmailchimp_get_subcampaign_reportGet report for A/B split sub-campaignRead

E-Commerce#

ToolDescriptionModemailchimp_list_ecommerce_storesList all connected e-commerce storesReadmailchimp_add_storeAdd a new e-commerce storeWritemailchimp_get_ecommerce_store_infoGet store details by IDReadmailchimp_delete_ecommerce_storePermanently delete a storeWritemailchimp_list_ecommerce_customersList customers in a storeReadmailchimp_add_or_update_customerAdd or update customer (upsert)Writemailchimp_get_ecommerce_customer_infoGet customer detailsReadmailchimp_delete_ecommerce_customerDelete customer from storeWritemailchimp_list_ecommerce_productsList products in a storeReadmailchimp_add_productAdd a new product with variantsWritemailchimp_get_ecommerce_product_infoGet product detailsReadmailchimp_update_ecommerce_productUpdate product infoWritemailchimp_delete_ecommerce_productDelete product from storeWritemailchimp_add_product_imageAdd image to a productWritemailchimp_list_ecommerce_product_variantsList product variantsReadmailchimp_add_or_update_product_variantAdd or update product variantWritemailchimp_get_ecommerce_product_variant_infoGet variant detailsReadmailchimp_delete_ecommerce_product_variantDelete product variantWritemailchimp_list_ecommerce_cartsList carts in a storeReadmailchimp_add_cartCreate a new cartWritemailchimp_get_ecommerce_cart_infoGet cart detailsReadmailchimp_delete_ecommerce_cartDelete cart from storeWritemailchimp_add_cart_line_itemAdd line item to cartWritemailchimp_update_cart_line_itemUpdate cart line itemWritemailchimp_delete_cart_line_itemRemove line item from cartWritemailchimp_list_ecommerce_ordersList orders in a storeReadmailchimp_add_orderCreate a new orderWritemailchimp_get_ecommerce_order_infoGet order detailsReadmailchimp_update_ecommerce_orderUpdate order statusWritemailchimp_delete_ecommerce_orderDelete order from storeWritemailchimp_add_order_line_itemAdd line item to existing orderWrite

Promo Codes & Rules#

ToolDescriptionModemailchimp_list_promo_rulesList promo rules for a storeReadmailchimp_add_promo_ruleAdd a new promo ruleWritemailchimp_get_promo_rule_infoGet promo rule detailsReadmailchimp_update_promo_ruleUpdate promo ruleWritemailchimp_delete_promo_ruleDelete promo ruleWritemailchimp_list_promo_codesList promo codes for a ruleReadmailchimp_add_promo_codeAdd promo code to a ruleWritemailchimp_get_promo_code_infoGet promo code detailsReadmailchimp_update_promo_codeUpdate promo codeWritemailchimp_delete_promo_codeDelete promo codeWrite

Events#

ToolDescriptionModemailchimp_list_custom_eventsList available custom eventsReadmailchimp_get_custom_event_templateGet custom event template by nameReadmailchimp_create_custom_eventCreate custom event for a memberWrite

Webhooks#

ToolDescriptionModemailchimp_list_webhooksList webhooks for a listReadmailchimp_add_webhookCreate webhook for list eventsWritemailchimp_update_webhookUpdate webhook configurationWritemailchimp_delete_webhookPermanently delete webhookWritemailchimp_add_batch_webhookAdd batch webhook for batch request eventsWrite

Surveys#

ToolDescriptionModemailchimp_list_surveysList surveys for a listReadmailchimp_create_survey_campaignCreate campaign linked to a surveyWrite

Customer Journeys#

ToolDescriptionModemailchimp_list_customer_journeysList customer journeysReadmailchimp_get_customer_journey_infoGet journey details by IDReadmailchimp_customer_journeys_api_trigger_for_a_contactTrigger journey step for a contactWrite

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#

text

┌─────────────────────────────────────────────────────────────┐
│  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 / ErrorMeaningTool not foundThe tool name does not exist in the current catalog. Verify with clawlink_list_tools --integration mailchimp.Missing connectionMailchimp is not connected. Direct the user to https://claw-link.dev/dashboard?add=mailchimp.Permission errorThe account lacks required plan or permission for this operation.List not foundThe list ID does not exist. Verify with mailchimp_get_lists_info.Campaign not foundThe campaign ID does not exist. Verify with mailchimp_list_campaigns.Write rejectedUser did not confirm a write action. Always confirm before executing writes.402 Payment RequiredFeature 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
• Mailchimp Marketing API Guide
• 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 — For MailerLite campaigns and automation
• Kit Email Marketing — For Kit email broadcasts
• Instantly Campaigns — For Instantly cold email outreach

---

Powered by ClawLink — an integration hub for OpenClaw