The MailChimp integration allows businesses using Pelcro to send automated emails based on events happening on Pelcro. It allows you to leverage the power of both Pelcro and MailChimp without requiring any code and the setup will take you 10-15 mins. You can control the copy, branding, and call-to-actions while leveraging data fed from the integration. Below are all the steps required to get you started.

Create a MailChimp account

To use the integration you'll need an active Mailchimp account. To get started or to know more about the Mailchimp sign up process, please click here

Note: If you're already on Mailchimp you can just use your existing account.

Create a Mailchimp Audience

The first step to getting started with Mailchimp is setting up your audience. According to Mailchimp, your audience is where you’ll store and manage all your contact data. It's the bedrock of our integration.

Required Audience fields

Audience fields and MERGE tags MUST have the following three fields:
1- field first name and field merge tag is: FNAME - This will be updated with the customer's first name.
2- field last name and field merge tag is: LNAME - This will be updated with the customer's last name
3- field token and field merge tag is: TOKEN - This will be updated with a password reset token every time a user requests one. The token is required to be MERGE field in order to use it as a link in the email. This is due to the fact that MailChimp doesn't support using Event API fields while creating links.

fields and merge tags in details

Can I use my existing Mailchimp Audience?

We recommend using a fresh new audience, however, you can use any Audience list in your Mailchimp account.

Get your Audience list ID

We'll need the Audience list ID from your MailChimp account. You can easily get it in five steps by clicking this link. After getting your list ID please save it in a secured place as we're going to use it in the integration.

Note the following requirements:

1- The selected audience list must have the three fields mentioned above.
2- The integration will overwrite any existing member's first name and last name.
3- The token will be updated with the latest token requested by the customer.

More information:

1- Create a Mailchimp Audience
2- Getting started with Mailchimp merge tags

Generate a Mailchimp API key

Using your managerial permissions on your Mailchimp account, please generate a new API key for the integration. Go to Account > Extras > API key.

For more details, please check out the link below:

1- Generate a new API key.

What's next?

Once you generate the API key, we recommend saving it in a secure place so we can use it later.

Now, log in to your Pelcro account

Pelcro Dashboard

Within your Pelcro's Dashboard, please find the "integration" icon on the left side menu.

click on integrationsclick on integrations

click on integrations


Click on the Mailchimp icon

click on the mailchimp integrationclick on the mailchimp integration

click on the mailchimp integration

Mailchimp Integration

What's next?

Just add the API key and the Audience List-ID that we've created earlier in this documentation, and click the ADD NEW green button.

Please note:

1- You'll not be able to restore or read the full API key string after clicking 'ADD NEW' As we masked it following our security protocols.
2- We'll show the last four characters of the API key unmasked so you can recognize it.
3- If you clicked 'DELETE KEYS', this will deactivate the integration immediately.
4- To reactivate the integration one more time you'll have to add your API key and Audience List ID as described above.
5- You can select "Sync newsletters into MailChimp" and this will sync all newsletters that are created in Pelcro with MailChimp.

  • Creating a newsletter for an email will create or update the customer on Mailchimp and the lists will be synced into tags
  • The customer will be added to the same audience list provided in the integration

Before we go back to MailChimp

Now, we assume/hope that everything went well so far till this point. Before we get back to Mailchimp please use your Pelcro account to create a test customer. This way we can walk you through the next steps of using the best of the integration features.

Now it's the Time to get back to Mailchimp

Go to your Mailchimp account and open the Audience List that you used with our integration. You'll find that the user John Doe has been added to your LIST automatically.

Breakdown of the process

Mailchimp API custom events

We're using the most up-to-date Mailchimp feature called API CUSTOM EVENTS. With this feature, we're not just adding your Pelcro's customers to your Mailchimp Audience but also we're continuously updating their Mailchimp profiles with "Events activity'.

What exactly are Events Activities?

Each time any of your customers do something on Pelcro, we add a new Event activity to his profile on Mailchimp. Activity data will be handy and you can build emails, statistics, and different feedbacks on top of it.

John updated his first name to Johnson.

The integration will update John's Mailchimp profile and adds a new Event activity called customer_updated to his Activity Feed.

Johnson created his first subscription

The integration will add a new Event activity called subscription_created to Johnson's Mailchimp profile. Inside this activity, you'll find all the necessary information that's related to the new subscription that Johnson created. In addition, you'll find all the details of the subscription below.

Now, Let's map out our Events


event name: customer_created
usage: This event is triggered when a new customer record has been created.
attached event data:



event name: customer_updated
usage: This event is triggered when an existing customer record has been updated.
attached event data:



event name: customer_reset_password
usage: This event is triggered when the customer has requested a password reset. As part of the password reset email being sent out to the customer, you will need to include the password token. Below is an example of how you should build the link based on the user email and the password token.
attached event data:



event name: subscription_created
usage: This event is triggered when a new subscription has been created for a customer.


event name: subscription_gift_donor
usage: This event is triggered when a donor has purchased a gift subscription for a recipient. You can use it to build logic around sending emails to donors


event name: subscription_gift_recipient
usage: This event is also triggered when a donor has purchased a gift subscription for a recipient, but it is meant to be used for Recipients. You can use it to build logic around sending emails to recipients with their gift code.


event name: subscription_gift_notification
usage: This means it is the time to notify the customer of his gifted subscription.


event name: subscription_updated
usage: This event is triggered when the customer subscription has been updated.


event name: subscription_canceled
usage: This means this customer has canceled a subscription


event name: subscription_trialwillend
usage: This means the subscription's trial period will end in three days, or when a trial is ended immediately.


event name: subscription_renewed
usage: This means this customer has renewed his subscription..


event name: subscription_expired
usage: This means this customer's subscription was expired.

subscription events' data:

  'subscription_plan', // Plan name
  'subscription_product', // Product name


event name: invoice_created
usage: This means this customer has a new invoice


event name: invoice_payment_succeeded
usage: This means the customer's attempt to pay an invoice was succeeded.


event name: invoice_payment_failed
usage: This means the customer's attempt to pay an invoice was FAILED.

invoice events' data:



event name: charge_succeeded
usage: This means the attempt of charging the customer succeeded and a charge is created.


event name: charge_failed
usage: This means the attempt of charging the customer failed.


event name: charge_refunded
usage: This means the attempt of refunding a charge to the customer was succeeded. And the customer was refunded.

charge events' data:



event name: source_expiring
usage: This means the customer's payment source or his card will expire at the end of the month.


event name: source_canceled
usage: This means the customer's payment source or his card is canceled.

source events' data:



event name: address_created
usage: This means this customer has added a new address


event name: address_updated
usage: This means this customer has updated his address
address events' data:


Finally, let's send a notification

Let's use what we learned so far to send a subscription confirmation email. It will be sent automatically once the user creates their new subscription on Pelcro.

Go to automate and click on the Email link

Now, select API, and then Event API

Name your email campaign

Click edit the trigger

Now copy the event "subscription_created" and add it as the event name and click update trigger

Please note

1- You must copy the event's name from this document.
2- Note that you have all the events and their data properties
3- You must paste the custom event name in the event name field as shown below.
4- Formating the event data attributes may not work according to some of our tests "|EVENT:subscription_product|" - please avoid formatting the event attributes.

Then, click next to add a subject and sender information. Afterward, fill out all the Mailchimp requirements until you reach the Email Message Body.

Customize your email using merge tags and event merge tags

To access any of the subscription created event data (which we listed above), you can easily use it inside the Email body as shown in the picture below. "|EVENT:subscription_plan|"

Email will look like this:

Sample email for the subscription_created event.

Hey *|FNAME|*, 

Thank you for subscribing to the following:

Product: *|EVENT:subscription_product|*
Plan: *|EVENT:subscription_plan|*
Start date: *|EVENT:current_period_start|*
End date: *|EVENT:current_period_end|*

Please reply to this email if you have any questions.


Business Name

Use merge tags to generate personalized links

Email template

Prepare your email message in your template

Add link

Use the button link from your Mailchimp toolbox on the right side of the screen

Select Web Address

In the web address (URL) input, please add your website link.


Click insert and the link will be ready

More information

Please click here

Mailchimp API Custom event video tutorial

If you couldn't apply the previous example or for any reason you want more information, we recommend visiting the Mailchimp API custom event video tutorial. It's a great help in learning how to use and implement automated emails using API custom events.

For the Mailchimp API CUSTOM EVENT please click here

Mailchimp webhook support

Pelco's Mailchimp integration is now capable of generating a unique webhook URI per account, With a hashed unique URIs you can sync back all the Mailchimp list unsubscribes to your Pelcro's integration.

For the Mailchimp webhooks please click here


Maximum number of members in the audience list

If you exceed your MailChimp account limit without upgrading, the integration will automatically be de-activated.

Did this page help you?