The integration with Mailchimp consumes API limits for actions that are sent from Mailchimp to Voucherify.
Step 1: Integrate Voucherify with Mailchimp account
To connect your Mailchimp account to Voucherify, follow these steps:- Go to the Home section and choose Integrations tab.
- Find Mailchimp integration and click Connect.
- Log in to your Mailchimp account to authorize the integration.
Step 2: Sync Mailchimp audiences
Once your Mailchimp account is connected, sync Mailchimp audiences and customers’ attributes with Voucherify. Go to Settings (Integrations tab -> Mailchimp) to see the details of the integration. Click Sync Audience to sync your Mailchimp contacts.- Select an audience to sync with.
- You can also add custom attributes to customer profiles from the list as metadata. Metadata will be visible in each customer profile in Voucherify (optional).
- Confirm syncing with Add Audience.
Step 3: Attach Voucherify codes to contact’s profiles in Mailchimp
Voucherify codes can be sent to customers’ Mailchimp profiles and attached as merge tags to your emails. To deliver codes to customer profiles, you need to:- Create a customer segment for customers from a particular Mailchimp audience.
- Create unique codes in the Voucherify dashboard.
- Schedule segment-based distribution of unique codes in the Voucherify dashboard.
Build a customer segment for the Mailchimp audience
In Voucherify, you can divide your customers into segments. When your Mailchimp account is synced, you can add a customer segment in Voucherify that represents a synced Mailchimp audience.- Add customer’s metadata schema in Project Settings that will store the name of Mailchimp audience.
- In the Integrations tab, use this metadata when syncing an audience. As a result, every new subscriber in the Mailchimp audience that is synced with Voucherify will be created as a customer. The metadata will be set to the defined value.
- Go to the Customers tab and click Find and apply filtering button to add a customer segment in Voucherify that represents the synced Mailchimp audience.
- In Metadata, choose the defined metadata.
- Click Apply to see the list of customers who are in this segment.
- Save the segment as a dynamic segment so new users will be added when they meet the segment criteria.
Create unique codes
Create unique codes that you will use in the Mailchimp email campaign. The codes will be attached to customer profiles as merge tags. You can create unique discount coupons, gift cards, referral codes, or loyalty cards and forward them to your Mailchimp account. Follow the respective tutorial to learn more about generating unique codes:Validation rulesUse validation rules to limit code redemptions to the chosen Mailchimp audience represented by the Voucherify customer segment. As a result, only customers from a particular audience (segment) will make a successful redemption.
Schedule segment-based distribution
- In the Engagement section, click Distributions.
- Name the distribution and choose the automation trigger – Customer entered the segment.
-
Define the trigger of the distribution.
Only the following trigger categories can use Mailchimp as a distribution channel:
- Custom events
- Manual messages
- Cart related activity
- Segment related activity
- In Action, choose the Send and publish unique codes from campaign action and select your voucher campaign
- In Channels, choose Mailchimp as a distribution channel and add a list of your receivers (a synced Mailchimp audience).
- Add the name of the merge tag, a unique label that identifies your code in the customer’s profile in Mailchimp.To assign codes properly, you need to add the merge tag that identifies your code to the list of merge tags in the Mailchimp audience before you save and start distribution in Voucherify. Go to the Adding merge tags for more details. When ready, put the added merge tag name into the Code presenting published voucher field. You can also map optional merge tags with QR code, barcode, and code attributes (value, publication date). QR and barcodes, need to be mapped to image merge tags.
- When mapping is ready, go to Summary to review your distribution configuration. Confirm the distribution with Save & Send.
- To assign codes properly, you need to add the merge tag representing the code to the merge tags list in the Mailchimp audience.
- Keep in mind that this process will only work for newly added accounts after syncing the Mailchimp audience and setting the distribution live.
Step 4: Set up Mailchimp automation
When your codes have been already assigned with the Voucheify distribution, you can set the automation workflow and deliver coupons straight to the customers’ mailboxes in a nicely designed email.- Create a new email campaign in Mailchimp.
- Choose Automated mode and then, email trigger (Welcome new subscribers) to set a segment-based send out.
- In the next step, name your automation and choose your audience (receivers). Confirm with Begin.
- Set the automation workflow by switching to advanced settings.
- In the advanced settings, you can set automation timing and add other conditions to be met to send an email. Add a segment with additional criteria. Filters in the segment provide that the message is sent automatically when the merge tag with the Voucherify distribution code appears in a customer’s profile. Mailchimp filters enable you to add this rule by a merge tag name combine with is not blank option.
- Confirm with Save segment and then go through three stages of email creation:
- Setup – put the email subject, signature, etc.
- Template – choose from saved templates or create a new one.
- Design – fit your template into a current subject and add merge tags with the code.
- Once the template is ready, you can confirm the workflow and start sending emails.
Manage merge tags with Voucherify codes
To successfully run a Voucherify distribution and assign codes to Mailchimp contacts, you need to add a merge tag representing a published (assigned) code to merge tags list in Mailchimp audience. The name of the merge tag defined in the merge tags list in Mailchimp needs to be the same as the name of the merge tag defined in the Voucherify distribution. You can also add a merge tag for a QR code and barcode by using the following syntax:- The name of the merge tag represents the code’s text format (required merge tag): newsletter_code (merge tag type: text).
- The merge tag with a QR code: newsletter_code_qr (merge tag type: image).
- The barcode: newsletter_code_barcode (merge tag type: image).
Export campaign codes from Voucherify to a Mailchimp Audience
Besides distributions, you can use the CSV export to deliver campaign codes to synced audiences. As a result, each contact from the chosen audience will get a new merge tag with a promo code in their profile.Step 1: Create a campaign of unique codes
Create a new campaign with unique coupon codes or gift cards. Codes from this campaign will be assigned to customer profiles in Mailchimp audience. Each customer receives only one unique code which is also assigned to their profile in the Voucherify dashboard.Step 2: Export CSV file with campaign codes
Codes will be exported from Voucherify and automatically imported to your Mailchimp account. Each customer from the chosen audience will get a unique code assigned to their profile under a predefined merge tag.- Click the campaign name and choose Export to Mailchimp from the right corner menu.
- Choose the audience and define a name for a merge tag with code.
- Confirm with Export.
Export limitYou can export up to 100 codes in a single request. To export codes to more than 100 contacts, wait until the first export is finished and start another export. Voucherify will assign the codes to the next 100 contacts who have not received the code yet.
Birthday campaign with Mailchimp
Learn how to create a birthday campaign with Mailchimp.- Add birthday dates to your customers in Mailchimp.
- Create a coupon campaign.
- Set the automatic distribution of codes.
- Launch Mail Chimp Automation.
Add birth dates to Mailchimp
First, you need to configure birth dates in Mailchimp:- Log in to your Mailchimp account.
- Go to the Audience tab and View Contacts.
- In the Settings section, go to Audience Fields and Merge tags.
- Add a new tag, “Birthday”.
Make sure that you have some text tags that will be used as fields for Voucherify codes.
Generate discount codes
In Campaign Hub:- Go to Campaigns.
- Create a new discount campaign with 20% discount codes and a maximum discount value of $300.
- Name your campaign, determine how many vouchers you want to generate, and play around with the code pattern optionally.
- Set optional time limitations.
- Define the discount type and value.
- Optionally, add validation rules. The codes will be redeemable once per customer to avoid coupon fraud. (Budget constraints -> Redemptions per customer in a campaign)
- Save the campaign and move on to the Distribution.
Launch Voucherify distribution (codes assignment)
The Distribution will act differently with this campaign as it does not involve sending a message to a customer but instead attaching discount codes to particular customers. You can also publish (assign) codes to customers via Publication API.- In Engagement, go to Distributions.
- Click Create Distribution.
- In Trigger, select the event that will trigger the distribution.
- Provide the distribution name.
- In Action, select the kind of distribution you want to create.
- In Channel, select the Mailchimp distribution channel and prepare a message layout.
- To add the codes to Mailchimp messages, provide the name of the merge tag that will be filled with a given code in Mailchimp emails.
- In Summary, check the configuration of your distribution.
- In Mailchimp, create email automation.
- Go to Automate and E-mail. For example, create a “Say ‘happy birthday’” email.
- Name your campaign and select the target audience from your Mailchimp Audience list.
- Next, establish the general workflow of your email campaigns, including triggers, schedules, filters, and post-send actions.
- Filter the segment to ensure that the messages are received only by the customers who provided their birthday date. All contacts from the list must meet specific criteria: the birthday tag cannot be left blank.
- Fill in general information about the email, such as the name, subject, email snippet, and sender’s information.
- Next, select your template based on a layout or theme. You can also reuse some of your old templates. In the last stage, design your mail. The most important part of the design process for our tutorial are merge tags. Thanks to them, your customers will receive their emails with unique codes. Use the same merge tag in your Mailchimp email as the one provided in Voucherify Distribution.
- Confirm with Start Sending and enjoy your first Mailchimp and Voucherify automation.

