Skip to content

mailchimp.md

Latest commit

 

History

History
150 lines (111 loc) · 2.81 KB

mailchimp.md

File metadata and controls

150 lines (111 loc) · 2.81 KB

Mailchimp

Email marketing platform for campaigns, automation, and audience management.

Capabilities

Integration Available Notes
API ✓ Marketing API for campaigns, audiences, automation
MCP ✓ Available via Mailchimp MCP server
CLI - Not available
SDK ✓ Official SDKs for multiple languages

Authentication

  • Type: API Key or OAuth 2.0
  • Header: Authorization: Bearer {api_key} or Authorization: apikey {api_key}
  • Base URL: https://{dc}.api.mailchimp.com/3.0/ (dc = datacenter from API key)

Common Agent Operations

List audiences (lists)

GET https://{dc}.api.mailchimp.com/3.0/lists

Get audience members

GET https://{dc}.api.mailchimp.com/3.0/lists/{list_id}/members?count=100

Add subscriber

POST https://{dc}.api.mailchimp.com/3.0/lists/{list_id}/members

{
  "email_address": "user@example.com",
  "status": "subscribed",
  "merge_fields": {
    "FNAME": "John",
    "LNAME": "Doe"
  }
}

Update subscriber

PATCH https://{dc}.api.mailchimp.com/3.0/lists/{list_id}/members/{subscriber_hash}

{
  "merge_fields": {
    "FNAME": "Jane"
  },
  "tags": ["customer", "premium"]
}

Get campaigns

GET https://{dc}.api.mailchimp.com/3.0/campaigns?count=20

Get campaign report

GET https://{dc}.api.mailchimp.com/3.0/reports/{campaign_id}

Create campaign

POST https://{dc}.api.mailchimp.com/3.0/campaigns

{
  "type": "regular",
  "recipients": {
    "list_id": "{list_id}"
  },
  "settings": {
    "subject_line": "Your Subject",
    "from_name": "Your Name",
    "reply_to": "reply@example.com"
  }
}

Send campaign

POST https://{dc}.api.mailchimp.com/3.0/campaigns/{campaign_id}/actions/send

List automations

GET https://{dc}.api.mailchimp.com/3.0/automations

Key Metrics

Campaign Report Fields

  • emails_sent - Total sent
  • opens - Open count
  • unique_opens - Unique opens
  • open_rate - Open rate
  • clicks - Click count
  • click_rate - Click rate
  • unsubscribes - Unsubscribe count
  • bounces - Bounce count

Subscriber Hash

Calculate subscriber hash for updates:

const hash = md5(email.toLowerCase());

Subscriber Statuses

  • subscribed - Active subscriber
  • unsubscribed - Unsubscribed
  • cleaned - Hard bounce
  • pending - Awaiting confirmation
  • transactional - Transactional only

When to Use

  • Managing email lists and subscribers
  • Creating and sending email campaigns
  • Setting up email automation
  • Analyzing campaign performance
  • Segmenting audiences
  • A/B testing emails

Rate Limits

  • 10 concurrent connections
  • 10 requests per second
  • Batch endpoints for bulk operations

Relevant Skills

  • emails
  • analytics
  • referrals