add_member
Add a new contact to a Mailchimp audience. Provide email address and list ID; optionally include name and tags. Returns member details or error if already present.
Instructions
Add a new member to an audience with optional name and tags.
Creates a new contact. Returns "Member Exists" error if already present. Choose the right member tool: add_member for new contacts, update_member to change profile/status of existing contacts, tag_member to manage tags on existing contacts, batch_subscribe for bulk add/update (up to 500), unsubscribe_member to opt out, delete_member for permanent GDPR removal. Side effect: status='pending' triggers a double opt-in confirmation email.
Authenticated via API key. Max 10 concurrent requests. Respects read-only and dry-run modes.
Args: list_id: Audience/list ID (10-char alphanumeric, e.g. 'abc123def4'). Obtain from list_audiences. email_address: Email of the new member. Must not already exist in the audience. status: 'subscribed' (default), 'pending' (triggers opt-in email), 'unsubscribed', 'cleaned'. first_name: First name (FNAME merge field). last_name: Last name (LNAME merge field). tags: Comma-separated tag names (e.g. 'VIP,Newsletter'). Created automatically if new.
Returns: JSON with id (MD5 hash of email), email_address, status, full_name.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| list_id | Yes | ||
| email_address | Yes | ||
| status | No | subscribed | |
| first_name | No | ||
| last_name | No | ||
| tags | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |