add_member_event
Record a custom event for an audience member to trigger automations and power segmentation.
Instructions
Record a custom event for an audience member (e.g. 'purchased', 'viewed_pricing').
Use to log member activity that can trigger automations or power segmentation. Use get_member_events to read a member's recorded events and get_member_goals for tracked Goals.
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: The member's email address. The subscriber hash is derived automatically. name: Event name (letters, numbers, underscores; max 30 chars, e.g. 'purchased'). properties: Optional dict of custom key/value properties describing the event. account: Optional account name (e.g. 'marketing') configured via MAILCHIMP_API_KEY_. Omit to use the default account. See list_accounts.
Returns: JSON confirming the event was recorded, or an error object if the member is not found or the input is rejected. On success the Mailchimp API returns an empty body (HTTP 204).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| account | No | ||
| list_id | Yes | ||
| properties | No | ||
| email_address | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |