Use Events for Behavioral Targeting
Our Events endpoint transfers contact activity from another app into Mailchimp. Events are customizable, so you can create them to meet your needs. You can then use the behavioral data you collect to segment your audience and send targeted campaigns.
In this article, you'll learn how to use custom events to segment your audience and send targeted campaigns.
Before you start
- The Events API endpoint is available to all Mailchimp users for event-based segments, event property merge tags, and single event-triggered automated emails. Event-triggered automated email series require a Standard plan or higher. Event property segments require a Premium plan. Learn more about our plans.
- Make sure the user data you collect conforms with Mailchimp’s Terms of Use and local privacy laws.
- Before you use this endpoint, you must add contacts to your audience.
About events
Custom events provide up-to-date insights about your audience. After you or your developer create a custom event, you can track interactions that help you market to each person’s specific needs. We recommend that you create custom events for the key events you want to track, then use event data to create segments or trigger behavior-targeted campaigns.
When you create and name your event, you can also add properties to that specific event to gather extra context. Properties provide more detail about how your contacts interact with an event, which makes the information you collect more valuable. For example, you could use properties to specify the account type that a user signed up for, or the physical location where they attended a conference.
Create an event
You can create custom events in Mailchimp with the API or with a third-party integration.
With the API
If you’re familiar with our API or have access to a developer, you can use our Events endpoint to create custom events and add properties as needed.
With a third-party integration
If you aren’t familiar with our API and don’t have access to a developer, you can use a third-party integration like Zapier to connect another app to Mailchimp and create custom events for things that happen in that app.
Use Zapier to create events
When an activity occurs with one of your contacts in another app, Zapier will create a new event as long as an email address is collected.
To create a custom event with Zapier, follow these steps.
- Log in to Zapier and click Make a Zap.
- Choose the app you want to connect to Mailchimp and the event that you want to trigger a Zap.
- Click Continue.
- Choose an existing account for the third-party app, or or choose Add a New Account to register a new one.
- Click Continue.
- Choose Mailchimp as your app and choose Create Custom Event as your action event.
- Click Continue.
- Click the Choose Account drop-down and choose your Mailchimp account. If you want to add a new account, click Add a New Account and log in through the pop-up modal.
- Click Continue.
- Now you’ll customize your event. Choose the audience, the email address collected from the app, the event name, and any event properties you want added to the event.
- Click Continue.
- Click Test + Continue to send a test custom event, or click Skip Testing. When you’re done, click Done Editing.
Well done! After you configure your action settings and turn on the Zap, your connected app will create custom events in Mailchimp.
Note
Zapier is a third-party integration. For technical assistance, reach out to Zapier Support.
View events
When an event occurs for a contact, you can view it on the activity feed of their contact profile.
To view events, follow these steps.
- Click the Audience icon.
- Click All contacts.
- If you have more than one audience, click the Current audience drop-down and choose the one you want to work with.
- Click a contact's email address to open their contact profile.
- In the contact profile, you’ll see event data in the activity feed. Click Show details to see the event properties.
Create and send campaigns to a segment
Build an audience segment based on event data and use it to create targeted emails, ads, and postcards. Custom event data can be used for segmenting up to 30 days after the event occurred for Free and Essentials accounts. Standard accounts keep event segment data for 3 months and Premium accounts for 18 months. Event property conditions are available with advanced segments only.
To create and send a campaign to a segment, follow these steps.
- Click the Audience icon.
- Click All contacts.
- If you have more than one audience, click the Current audience drop-down and choose the one you want to work with.
- Click New Segment.
- Choose the App Engagement option from the first segment category drop-down menu.
- In the second drop-down menu, choose the name of the event you want to segment.
- In the third drop-down menu, choose one of these segmenting options:
- Occurred
- Not occurred
- Occurred before [specific date]
- Occurred after [specific date]
- Occurred within [1 day, 7 days, or 1 month]
- Not occurred within [1 day, 7 days, or 1 month]
- Click Preview Segment.
- Click Edit to make any changes. When you're ready, click Save as segment.
- In the Save Segment pop-up, type a descriptive name for the segment, and then click Save.
Success! After you've saved your segment, send a campaign from the contact table or choose the segment in the campaign builder.
Trigger an automated email
Trigger an automated email that sends when an API call with the event name posts. Accounts on the Standard plan or higher can also create an automated email series triggered by events.
To create an automated email that sends based on a specific API event, follow these steps.
- Click the Automations icon.
- Click Email.
- Click the API tab and choose Event API.
- Enter a campaign name and select an audience from the drop-down menu.
- Click Begin.
- Find the Trigger setting and click Edit.
- On the Edit Trigger modal, choose the Delay and enter your Event Name.
Make sure the event name matches the name field you entered when you created the event. The API endpoint example shows the information that you’ll need to supply in your API call to trigger this event. - Click Update Trigger.
Compare event plan permissions
Here are the custom event actions that are available with each Mailchimp plan.
Account Actions
Event Features | Free | Essentials & Legacy Paid | Standard | Premium |
---|---|---|---|---|
Events endpoint | ![]() | ![]() | ![]() | ![]() |
Events in contact profile | ![]() | ![]() | ![]() | ![]() |
Event-based segments | ![]() | ![]() | ![]() | ![]() |
Event data availability (for segmenting) | 30 days | 30 days | 3 months | 18 months |
Event-based automated email | ![]() | ![]() | ![]() | ![]() |
Event-triggered automated email series | ![]() | ![]() | ![]() | ![]() |
Event property merge tags in automated emails | ![]() | ![]() | ![]() | ![]() |
Event property segments | ![]() | ![]() | ![]() | ![]() |
Technical Support

Have a question?
Paid users can log in to access email and chat support.