All tools
M
by Mailchimp
Add an event for a contact
Records a named event, with optional properties and time, for one audience contact.
Updated Sep 27, 2026
add-list-member-event.md
Add an event for a contact
Records a named event, with optional properties and time, for one audience contact.
Note: Events can trigger automations: set is_syncing to true when importing ones that shouldn't. The event name is 2 to 30 characters.
Set up
Use the first option your agent supports.
API (official)
- Base URL: https://{dc}.api.mailchimp.com/3.0
- Endpoint:
POST /lists/{list_id}/members/{subscriber_hash}/events - Auth: send the header
Authorization: Bearer $MAILCHIMP_API_KEY - Get a key: https://us1.admin.mailchimp.com/account/api/
- Docs: https://mailchimp.com/developer/marketing/api/
Note: {dc} is your data center, the part of the API key after the dash, such as us6.
Before anything else, confirm access with the cheapest read-only call, like a list or a search. Never send or change anything to test access.
Rules
- Ask the user before anything that sends messages, costs money, or changes data, and say how many records it touches. One approval covers a batch the user has seen.
- Never print API keys.
Ways in
| Route | Source | Call | Required | Docs |
|---|---|---|---|---|
| Official | POST /lists/{list_id}/members/{subscriber_hash}/events | API key in $MAILCHIMP_API_KEY | Docs |
Workflows using Add an event for a contact
No workflows yet
No published workflow uses Add an event for a contact yet.