update_member
Update a subscriber's status and profile fields in a Mailchimp audience. Only provided fields are changed; omitted fields remain unchanged.
Instructions
Update a member's profile fields or subscription status. Does not manage tags.
Only provided fields are updated; omitted fields remain unchanged. Idempotent: re-applying the same values is safe. Side effect: changing status to 'pending' triggers a re-confirmation email. Choose the right member tool: update_member for profile/status changes, tag_member for tag management, unsubscribe_member as shortcut for opt-out, add_member if the contact does not exist yet, batch_subscribe for bulk operations.
Authenticated via API key. Max 10 concurrent requests. Respects read-only and dry-run modes. Returns 404 error if member does not exist. Returns 400 if status transition is invalid (e.g. cleaned to subscribed).
Args: list_id: Audience/list ID (10-char alphanumeric, e.g. 'abc123def4'). Obtain from list_audiences. email_address: Email of the member to update. Must exist in the audience. status: New status: 'subscribed', 'unsubscribed', 'cleaned', 'pending'. first_name: New first name (FNAME merge field). last_name: New last name (LNAME merge field).
Returns: JSON with id, email_address, status, full_name.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| list_id | Yes | ||
| email_address | Yes | ||
| status | No | ||
| first_name | No | ||
| last_name | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |