Get information about all lists (audiences) in the account. (docs)
GET /3.0/lists
🟢 low
— no
Get information about members in a specific list/audience. (docs)
GET /3.0/lists/{list_id}/members
🟢 low
— no
What the agent can do
Capability
API call
Risk
Needs approval
Add a new member to a list with email and subscription status (carries marketing-consent/compliance obligations — CAN-SPAM, GDPR). (docs)
POST /3.0/lists/{list_id}/members
🔴 high
✅ yes
Connecting it
You provide: API key (e.g. ...-us19)
Where to get it: Mailchimp → Profile → Extras → API keys → create. The suffix after the last hyphen (e.g. us19) is the datacenter used in the API base URL.
Permissions/scopes:none / not scope-based
Account setup
Account needed: Any Mailchimp account (Free or paid); API keys are available on all plans. An audience/list must exist before list/member operations.
App registration: API key via Account → Extras → API keys (single account). For multi-account, register an OAuth2 app via Account → Extras → Registered Apps for client_id/client_secret.
Verification required: No special API verification beyond a valid login.
Testing: No dedicated sandbox — test with a throwaway audience; use status='pending' on add_subscriber to trigger double opt-in (a confirmation email) rather than immediately subscribing.
Limits
10 simultaneous connections per account (HTTP 429 on exceed); 120-second per-call timeout.