Using PowerMailChimp in the UCI

To use PowerMailChimp in the Unified Interface (UCI), we've created a model driven app. You will need to use PowerMailChimp through this model driven app in order to experience proper functionality. The model driven app is included in versions and above. When you install a version above, you will notice a new PowerMailChimp app in the UCI:

Once you open the PowerMailChimp app, you will notice the PowerMailChimp components (Marketing Lists, Organize Merge Tags, PowerMailChimp Blasts), along with the following sections:

  1. Get help: You will have the ability to easily open support cases, post ideas to our customer ideas forum, and browse our FAQ from within the UCI navigation
  2. Setup: You will have the ability to open the configuration page from within the app, and will have the user guide readily available
  3. Explore: You will be able to easily explore other add-ons and find out what’s new in the HCLTech Microsoft Business Applications Practice world

Security Roles

After you import PowerMailChimp, you will notice several new security roles in your Dynamics 365 system. Each user you want to be able to have some level of use for PowerMailChimp will need one of the security roles below. Users will also need to be assigned the PowerMailChimp AppUser role to access the PowerMailChimp model driven app.

If you are using server-to-server authentication, the PowerMailChimp user role along with a role that allows you to read/write (for example, a sales admin role) will need to be assigned to the application user that was created for authentication.

System Administrators will automatically be able to use PowerMailChimp and no additional security roles are required.

PowerMailChimp Read-Only

The PowerMailChimp Read-Only user security role is meant to be assigned to any CRM user who would like to see the PowerMailChimp blasts and statistics, but won’t have access to edit/update/delete the PowerMailChimp-related entities.

PowerMailChimp Do Not Allow Send or Schedule

The PowerMailChimp Do Not Allow Send and Schedule Blast security role is meant to restrict users from being able to send a PowerMailChimp blast. They can create and save the blast, but not actually send it out.

PowerMailChimp Hide Jump to MailChimp

The PowerMailChimp Hide Jump to MailChimp security role will give users full use of PowerMailChimp, but will hide the button that directs users to MailChimp.

PowerMailChimp User

The PowerMailChimp User security role will give users full access to the PowerMailChimp functionality, including sending out blasts, and anything else related to PowerMailChimp.

PowerMailChimp AppUser

This role should be assigned to anyone who wants to use PowerMailChimp via the model driven app.

PowerMailChimp Service User

The PowerMailChimp Service User security role should be assigned to the application user created for server-to-server authentication.

Configuring PowerMailChimp

After you have imported the PowerMailChimp solution, open the PowerMailChimp configuration page by navigating to advanced settings>settings>solutions>PowerMailChimp.

Open the MailChimp Configuration tab and add your MailChimp API key to the API key field. This will allow you to sync data to MailChimp.

The Marketing List Sync Duration field is set by default to 1 hour. This means that when you send a PowerMailChimp blast to a marketing list, if that marketing list has not been synced in the past hour, the list will sync automatically. You can adjust this value up to 3 days. Be sure to save before closing.

Note: A marketing list is only synced automatically when a blast is sent to that marketing list, and only if that list hasn’t been synced within the time frame set in your sync duration.

In the Target Service field, select the Azure cloud location that is closest to your organization.

Authenticating PowerMailChimp

To use PowerMailChimp, one of the two below forms of authentication is required. From November 9th onwards, PowerPack add-ons will be supporting ServertoServer authentication (recommended and supported for CRM online) along with IFD authentication (supported for on-premises). If you are on version or above of Dynamics 365, you will not be able to authenticate using username and password at all. Instead, you will be required to use ServertoServer authentication, as Microsoft turned off authentication using App password starting with this version.

Configuring PowerMailChimp using servertoserver authentication

Check out this blog for instructions on how to set up servertoserver authentication. Then, navigate to the PowerMailChimp configuration page authentication tab, and select “server-to-server” as your authentication method. Add your App ID, App Secret, and Tenant ID, and click on “save.”

Configuring PowerMailChimp using username and password

If your CRM is on-premise or you have a version of Dynamics 365 online that is below, you can still authenticate using username and password. If you have MFA enabled, you will need to create an app password and then enter in your username and app password into the PowerMailChimp configuration page as usual

Where can I find my
MailChimp API Key?

Login to your MailChimp account, and click on the name of your account. Then click on Account Settings > Extras > API Keys:

If you do not have an API key click on “Create a Key.”

Setting User Defaults

PowerMailChimp allows Administrators to restrict access to specific MailChimp template folders and MailChimp audiences per CRM user. To limit which MailChimp template folders or lists a user has access to, simply navigate to the user record, change the user form to information and type in the name of the template folder and/or MailChimp audience that the user should have access to (from the CRM side) in the PowerMailChimp section. If the user needs access to more than one template folder or MailChimp audience, please enter each folder/list on its own line.

If there is nothing entered in these two fields on the user record the user will, by default, have access to all templates/template folders, and have privileges to sync to all MailChimp audiences.

Template Folders

When creating your templates in MailChimp, you can choose to put the templates into folders, to help organize them. You can then choose to restrict access by CRM user, to which template folders the user can choose templates from when creating a PowerMailChimp blast inside of CRM.

MailChimp Audience

In MailChimp, it is best practice to have just one audience list that you will be syncing all of your CRM marketing lists to. However, if for any reason it makes sense for your company to have multiple audiences in MailChimp, you can choose to restrict which audiences CRM users can sync their marketing lists to.

Using PowerMailChimp

Once you have imported PowerMailChimp in Dynamics CRM, you will see a new set of options under the PowerPack section in the command bar; Marketing Lists, PowerMailChimp Blasts, and Organize Merge Tags. If you do not see these options, refresh your browser.

Syncing Marketing Lists

The first thing you need to understand is the relationship between Dynamics CRM Marketing Lists and the MailChimp Groups. Best practice for MailChimp is to create one Master Audience, then with each initial sync of a CRM Marketing List, a subgroup (with the same name) will be created within the Master Audience to segment the data.

Note: You will need to create your Master Audience in MailChimp before you can sync a Dynamics CRM Marketing List to it.

Note: You cannot have more than 60 groups in MailChimp at one time. In other words, you cannot sync more than 60 CRM Marketing Lists under one Master Audience in MailChimp.  Users can simply delete any or all groups in MailChimp to make room for new CRM Marketing Lists.

Manual Sync

After importing PowerMailChimp, you will see a PowerMailChimp tab on new and existing Marketing Lists. Marketing Lists need to be manually synced prior to their first use, to associate them with MailChimp, and will automatically sync when added to future blasts.

To sync CRM Marketing Lists, locate the PowerMailChimp tab on the Marketing List form and select the Select MailChimp List button.


In the window, select the MailChimp List, select OK, and Save the Marketing List.

Under the ellipses on the Marketing List, select the Sync Now button, and once the sync has started select Close.

PowerMailChimp Synchronized

Once you have sync’d a CRM Marketing list with your MailChimp Master List, you will notice the ‘MailChimp Synchronized’ section will appear under the sub-menu for your marketing list.

In the MailChimp Synchronized section you will find a record of the syncs for the specific Marketing List. This area will tell you the date of the sync and how many subscribers were added, updated and if there were any errors.

MailChimp Sync Errors

If you have an error on the sync record, you can open that individual sync record and check why there was an error with the sync. Once you select the individual sync record a new window will open where you can select MailChimp Sync Error(s) from the command bar.

Remember, sync errors are not necessarily a bad thing. Errors could be that someone has unsubscribed and cannot be added back to the list or an email has bounced too many times and cannot be added back.

If for some reason your Synchronization gets stuck, meaning you’ve clicked Sync Now, the process has started, but the process never completed, simply delete the Sync record, and click “Sync Now” again. However, remember to be patient, if the marketing list has a large number of members the sync will take longer.

PowerMailChimp Merge Tags

Merge tags are a great way to pull information from the CRM and transfer it into MailChimp templates. Merge tags can be used to create dynamic content in MailChimp templates, such as account numbers, birthdates, or other information.

To set up merge tags, navigate in the command bar navigate to PowerPack and select Organize Merge Tags, then select the entity you would like to customize merge tags for: Account, Contact or Lead. Remember, you will have to set up merge tags for each of these entities individually in order for that information to get sync’d with MailChimp. Don’t forget to click Save after organizing your merge tags for each of the different entities.

To use one of these merge tags in your MailChimp template, you would type *|name of merge tag|*. So, for example, if you wanted to use the Company Name merge tag in the screenshot below, you would type *|COMPANYNAM|*.

This is what you will see in the CRM...

…and this is what it will look like in MailChimp:

Note: If you are syncing a time/date field, be sure that MailChimp and the CRM are in the same time zone. Also, please note that you cannot have more than 30 merge fields in MailChimp at one time.

PowerMailChimp Blast

A PowerMailChimp Blast is a record that you must create to send a bulk email, all of the overall statistics of your email blast will be collected in this record. Also note that this record becomes read-only after sending and cannot be reused.

Note: Before creating a PowerMailChimp blast you must create an email template in your MailChimp account. If you need help designing a MailChimp template, please refer to MailChimp.

Create a PowerMailChimp Blast

Creating a PowerMailChimp Blast is quick and easy. First, navigate to PowerPack then PowerMailChimp Blast in the command bar. Click on New in the upper left-hand corner and a new form will be created.

General Tab

Fill in the general tab information and click on Save in the lower right corner. You must save the PowerMailChimp Blast before you can associate a marketing list to it.


This is a required field and is the internal name of the PowerMailChimp Blast in Microsoft Dynamics CRM and will be reflected as the campaign name in MailChimp This should be a somewhat logical name as you will most likely need to come back and reference it in the future. The name field does not allow the use of special characters. Alpha or numeric characters.

From Name

Each PowerMailChimp Blast requires a “From Name,” this is who the email is from when the recipient views it.


This is the subject of the email being sent and will be in the subject line of the email when it is received.


If desired, you can associate your PowerMailChimp Blasts to a Dynamics CRM Campaign.

Reply to email

This is the email address that will be used when a recipient chooses to Reply to the email. Best practice would be to use a generic email address rather than an individual’s email address (ex.

MailChimp Blast ID

A unique ID will automatically be populated by MailChimp when the PowerMailChimp Blast is completed and saved. The MailChimp Blast ID signifies that the PowerMailChimp blast is ready to be sent. If you do NOT get a MailChimp Blast ID, something isn’t quite right and you will be unable to send your blast. Additionally, before a Blast ID is created, the solution will automatically sync your marketing list one last time to ensure data is up-to-date in MailChimp.

Associated Marketing List Tab

Once you have saved the PowerMailChimp Blast, you can add CRM Marketing lists to which the email will be sent.

  1. Click the ‘+’ to the right of the Associated Marketing Lists section title and a search box will appear. If you do not get this option, please try saving the blast and try again.
  2. Select the list(s) that you want this PowerMailChimp Blast email sent to.
  3. Once selected you will be able to see the chosen Marketing List(s) in the Associated Marketing Lists grid.

Note: When using more than one marketing list in your PowerMailChimp blast, the lists must all be synced to the same MailChimp Audience

Email Tracking and Advanced Tracking

This section directly relates to what data MailChimp will track and report on after the email blast is sent. Send, open, click, bounce, and unsubscribe statistics will automatically be written back to CRM. Turning on the Email Tracking or Advanced tracking options in CRM will turn them on in MailChimp for this specific email blast being sent.

The default options are checked and will remain checked. The remaining options can be turned on based on your needs. For more information on these additional tracking capabilities please refer to MailChimp.

Track Opens

Checking this box will track how many people open your email, by default this box is checked.

Track Clicks

Checking this box will track how many people clicked on various links in your email, which links were clicked and how many times; this box is check by default.

Add Google Analytics

If you have linked a Google Analytics account to MailChimp, selecting this options to pass Google data back to MailChimp; the Google data will not be visible in CRM.  After selecting this option, a Title box will appear allowing you enter text to help identify the blast - by default this field will automatically populate with the blast name, date and time.

Track Plain Text Clicks

Track how many people clicked on links in your plain text email, which links they clicked on and how many times, this is checked by default.

Send to Twitter/Facebook

If you have linked your Twitter or Facebook account to MailChimp, checking this box will automatically tweet/post a link of the email message for people to visit on the web.


Authentication acts like a license plate for your email. It provides a traceable identifier which indicates you are probably legitimate, helping you avoid spam filters.

Add eCommerce 360 Tracking

If you have linked your online store to MailChimp, selecting this option will track when people click from your email blast, visit your website all the way to purchase.

Select MailChimp Template

The last step in creating the blast is to choose the MailChimp template that you want to send.

Please refer to the MailChimp website for further information about creating email templates.

Click on Select MailChimp Template and select the appropriate template from the Templates List, if needed you can preview the template by clicking Preview button. Select OK to confirm you choice.

Editing Email Content

If you need to make a quick edit to the text on your template, like correcting a typo or changing a date/time, you can do so directly from within Dynamics 365, but you will need to clone the blast first. Once you clone the blast, you will see the option to “edit email.” You will want to click on ‘Edit E-mail’ to select MailChimp Template, make your quick edit in the pop-up window and click OK.

Note: This will not change the template on the MailChimp side, changes are only reflected on the email being sent from that specific PowerMailChimp Blast.  Do not edit images, images should only be edited in MailChimp

Sending the PowerMailChimp Blast

Once you have all the details specified for your PowerMailChimp Blast, be sure to click on Save in the upper right-hand corner to be certain you have captured all changes you made to the form. You will know that your blast has been successfully saved in MailChimp when you get a MailChimp blast ID populated back in CRM.

Once all the pieces of the PowerMailChimp Blast have been filled out and/or selected and you have saved the record, the MailChimp options under the ellipsis (…) will become available:

You have 3 options: Send Test E-mail, Send Now or Schedule Delivery.

Send Test

You can send a test email up to 3 recipients, this is a great way see how the email will be rendered by different email services.

Note: When you receive a test email in your inbox, any merge tags you have in your template will not actually be replaced with the correct value. They will still say “FNAME” (or whatever the merge tag was)

Send Now

To send the PowerMailChimp blast immediately, click on Send Now from the ellipsis list and confirm that you want to send your email blast.

Schedule Delivery

You can choose to schedule the delivery of the PowerMailChimp blast for a future date by selecting the Schedule Delivery option from the ellipses.

As soon as you click on “schedule” the solution will check to see if the marketing list has been synced within the time frame you have set in the sync duration field in your PowerMailChimp configuration (you can check what you have your sync duration to by navigating to Settings>Solutions>Double click to open PowerMailChimp>MailChimp configuration>Sync duration). If the list has not synced within that time frame, it will automatically sync again.

It is important to note that the blast will not actually get scheduled and will not go out at the scheduled time, if the marketing list has not been synced successfully.

If all of the Marketing lists have successfully synced:

If some (or one) of the marketing lists are not synced:

If needed, you can unscheduled the blast by selecting the Un-schedule Delivery button in the ellipses menu.

Note: When a PowerMailChimp blast is sent the form becomes read-only.

Jump to MailChimp

If at any time you need to navigate to your MailChimp account, simply click on the “Jump to MailChimp,” button found in the ellipsis. This button can be found on the main PowerMailChimp blast view, as well as on each individual PowerMailChimp Blast record.

Copying a PowerMailChimp Blast

If you’d like to copy an existing PowerMailChimp Blast open the PowerMailChimp blast you would like to copy and select “Clone Blast,” from the ellipsis dropdown.

When a copy of a blast is created, “-copy,” will be added to the PowerMailChimp blast name, from name, and subject field. All parts of the blast, including the marketing list, template selected and PowerMailChimp Blast form fields will be copied.  If the MailChimp template has been changed in any way, you mush reselect the template to update the blast.

Adding Survey Links to a

If you are subscribed to PowerSurveyPlus, you have the ability to send a survey within your bulk email and track the survey responses back to the email recipient’s CRM record. To add a PowerSurveyPlus link to a blast navigate to the survey.  On the survey, select the Copy MailChimp Link, and copy the URL from the pop-up window.  Use this link in your MailChimp template to direct users to your survey.

Deleting a PowerMailChimp Blast

If you would like to delete a blast in CRM for any reason, you may do so. However, please know that if you delete a PowerMailChimp Blast all activities (opens, clicks, unsubscribes, etc.) that were associated to that blast, will also be permanently deleted. If you delete a blast in CRM that blast will also be deleted from MailChimp. Deleting a PowerMailChimp blast in CRM or a campaign in MailChimp is not suggested.

Note: You cannot delete a MailChimp campaign that has been sent in the past 7 days.

Viewing Statistics

After a blast is sent, the MailChimp statistics are tracked back to the corresponding blast and Account, Contact, or Lead record within CRM.

MailChimp Statistic Syncing

Blast statistics are synchronized from MailChimp into Dynamics CRM at regular intervals after the email blast is sent, with the length of the intervals decreasing after a period of time, as the open and click through rates naturally taper off.

Dynamics CRM will first synchronize the statistics one hour after the blast has been sent. After the initial data synchronization, the data will be synced at the following intervals:

  • Once per hour, for the first 72 hours after the blast is sent.
  • Once per day, days 3 - 6 after the blast is sent.
  • Once per week, weeks 2 - 4 after the blast is sent.

You can also choose to manually sync a PowerMailChimp blast by opening the blast and clicking "Sync". Please note that this button is only available after the PowerMailChimp blast is sent, and if there is no sync currently running.

On PowerMailChimp Blast Record

The header will show some raw statistical data, and the Dashboards section on the record allows users to dig further into those statistics, as well as view individual’s blast activities.

On a Record

To see the statistics on the record navigate, to the record and scroll to the PowerMailChimp tab. This section will show you all of the bulk email actions that this particular recipient has taken.

Within each PowerMailChimp activity you will see the activity type (send, open, click, bounce, unsubscribe). Each activity will list which bulk email the activity is associated to, as well an activity date.

PowerMailChimp Blast Reports

PowerMailChimp comes with two pre-built reports that you can run after the statistics begin syncing. From the ellipsis on the PowerMailChimp Blast record users can select ‘Run Report’ and then select the PowerMailChimp Blast Report or the PowerMailChimp Activity Type Summary Report:

The PowerMailChimp Blast Report gives you the top level and “Top 25” statistics all in one place:

The PowerMailChimp Activity Summary will allow you to select an activity type (send, open, click, etc.), choose a PowerMailChimp blast and list all leads, contacts or accounts that have that activity type. The report will list the person’s name, phone number, street, city, state, email address and the number of time that activity occurred for that person.

PowerMailChimp Dashboard

The PowerMailChimp dashboard will appear in the list of dashboards that you have in your CRM system. This dashboard will list all of the PowerMailChimp blasts that you’ve sent out in the past month and the activities associated to those PowerMailChimp blasts, in summary form.

Manually syncing stats

You can also choose to manually sync a Power MailChimp blast by opening the blast and clicking “Sync”. Please note that this button is only available after the Power MailChimp blast is sent, and if there is no sync currently running.

After 30 days of time after the blast is sent, the “Sync” button is available for manually syncing the PMC blast and pulling the Blast statistics.

Unsubscribes from MailChimp / CRM

When someone unsubscribes from your PowerMailChimp blast, an unsubscribe activity type will be created and associated to that individual’s CRM record. The unsubscribe activity does not automatically remove the recipient from your CRM marketing list or change their record's bulk email to Do Not Allow.  If you try to sync the person in the future, MailChimp will prevent it.

Within the unsubscribe activity, you will see the MailChimp Audience the person unsubscribed from and the reason unsubscribed (if given at time of unsubscribe).


Uninstalling PowerMailChimp

To uninstall PowerMailChimp, first delete any PowerMailChimp Blasts you created. Then uninstall as usual, by deleting the solution.

Deleting the solution will remove all records and activities associated with PowerMailChimp, including any PowerMailChimp activities. If you would like to keep this information in your system, you can simply unsubscribe and leave the solution in your system.

Thank you for your interest in PowermailChimp, should you choose to subscribe you will be charged $2.50/enabled CRM user/month. If you have any questions or run into any issues with PowerMailChimp, our friendly support team is here to help!

PowerMailChimp User Guide