
Get the job done with a pro
From training to full-service marketing, our community of partners can help you make things happen.
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 marketing emails.
In this article, you'll learn how to use custom events to segment your audience and send targeted marketing emails.
Before you start
Here are some things to know before you begin this process.
- The Events API endpoint is available to all Mailchimp users for event-based segments and event property merge tags. Paid marketing plans have access to the Event API starting point for Customer Journeys. To learn more, check out our pricing page. To change your plan type, visit the plans page in your account.
- 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 start a Customer Journey.
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. Use those events to create segments within your audience, or set up a pre-built journey map that adds contacts when events are created.
Keep in mind that Zapier is a third-party integration. For technical assistance, reach out to Zapier Support.
To create a custom event with Zapier, follow these steps.
- Log in to Zapier and click Create Zap.
- Choose the app you want to connect to Mailchimp and the event that you want to trigger a Zap.
- Choose an existing account for the third-party app, or choose Connect 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 custom 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.
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 Audience.
- 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 Audience.
- 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 Custom 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
- Has not occurred
- Occurred before [specific date]
- Occurred after [specific date]
- Occurred within [1 day, 7 days, or 1 month]
- Has 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.
Create an event-based Customer Journey
Create a Customer Journey that kicks off for a contact when an API call with the event name posts. Accounts on the Standard marketing plan or higher can create multi-step journeys with an Event API starting point. Accounts on the Essentials marketing plan can use the same starting point with a single-step journey.
To create a Customer Journey that adds contacts based on a specific API event, follow these steps.
- Click Automations.
- Click Customer Journeys.
- Click Create Journey.
- Enter a Customer Journey name and select an audience from the drop-down menu.
- Click Start Building.
- Click Choose a Starting Point
- Click API & Integrations.
- Click Event API.
- On the starting point modal, 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 Save Starting Point.
Compare marketing plan Event API 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 single-step Customer Journey | ![]() | ![]() | ![]() | ![]() |
Event-based multi-step Customer Journey | ![]() | ![]() | ![]() | ![]() |
Event property merge tags in Customer Journeys | ![]() | ![]() | ![]() | ![]() |
Event property segments | ![]() | ![]() | ![]() | ![]() |
Technical Support

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