This article provides information about the legacy Emma for Salesforce integration, which was sunset in 2020.

End of support notice for the Emma for Salesforce integration

The Emma for Salesforce integration that this article was initially created for is no longer updated or supported by Emma. Instead, we recommend that you switch to the Emma for Salesforce integration that’s created and maintained by Beaufort 12 (B12). While you can choose to leave the old version live in your account, Emma will no longer provide updates to it and our Support team cannot assist in troubleshooting issues with the integration moving forward.

Emma groups

When you open an Emma group within Salesforce, there are a lot of fields displayed. Here are some quick definitions describing what those fields mean:

Field	Meaning
Emma group name	The name you chose for this particular group.
Synced members	Number of members in this group that have been created in Emma. Note that this might not match the number you see in your group in Emma if there are duplicate email addresses on your report.
Total unique members	These are the number of unique records there are in this group based on their email address. Since Emma uses email address as its unique identifier, this number should match Members in Emma when the group is synced.
Members in Emma	This is the number of members in the corresponding group in Emma (Active, Error and Opt Out combined). This should match Total Unique Members when the group is in sync.
Total members	This number includes all records in the associated report, as well as any records in your account with the same email address. This number can be larger than the number of members in your report.
Number of leads	The number of leads in this particular group.
Number of contacts	The number of contacts in this particular group.
Number of non-contact / non-lead records	The number of records in the group that are neither leads nor contacts.
Emma group ID	The ID of the group record in Emma. It’s unlikely you’ll need this number, but it can be helpful when troubleshooting.
Emma sync status	This field describes the sync status of the group. If it says Synchronized, the Group Name and Group ID are properly synced with Emma. It does not necessarily mean that all the members in the group are synced. That status will show on the member records individually.
Emma last synced date	The last time this group data was synced.
Report link	A link to the report used to generate the group.
Created by	The user who created the group and the timestamp for when it was created.
Last modified by	The user who last modified the group and the timestamp for when that happened.

How to create a new Emma group from the groups section

1. Click the New Emma Group button on the main "Emma Groups" page.
2. Enter a name for the group you'd like to create.
3. Click on the Save button.

How to add a lead or contact to a new group

1. From the lead or contact record, click the New Emma Group Membership button.
2. The name of the lead or contact will automatically appear on the left.
3. Enter the group that you'd like to add them to on the right.
4. Click on the Save button.

How to add a new lead or contact to a group from the groups section

1. Click the New Emma Group Membership button.
2. Enter the name of the lead or contact that you'd like to add.
3. Click on the Save button.

Please note: You can only add one member at a time, so be sure to add either a lead or contact here — not both.

Custom report types

When you’re creating Emma groups from reports, any report that contains an Object ID that relates to an individual can be used to create that group. However, we recommend that you use Custom Report Types in Salesforce for the best results. This is especially true if you’re working with large reports (over 100,000 records) or if you are reporting on a custom object.

The Emma for Salesforce application comes with a few pre-built custom report types. They are:

• Emma Account
• Emma Contact
• Emma Lead
• Emma Mailings with Contacts and Leads
• Emma Mailings with Emma Emails with Email Actions
• Emma Mailings with Mailing Links with Email Actions

However, you can use any Custom Report Type, including ones that you create. Click here for instructions on how to create these.

How to create a new group from your report

1. Click on the New Emma Group button on the main Emma Groups page.
2. Check the box marked Also add members from Salesforce report.
3. Choose the folder where the Salesforce report you wish to use is located (we recommend using the Emma Emails folder for storing reports for group creation).
4. Choose your report in the Select Report dropdown menu. Keep in mind that your report must include the Object ID (contact ID or lead ID) in addition to an email address to be eligible for import into the selected Emma Group.
5. (Optional) If you’re using a Custom Report Type, you’ll see a field called Select Member Field. Select the field that you’d like to use to identify the members for the group.
6. (Optional) If you'd like this group to Auto Refresh each day, check the box next to "Auto-Refresh Group Members." This must be configured in the Emma Setup in the Sync Options step.
7. Click on the Save button.

Pro tip: You can also populate an Emma group with only one Salesforce report. If you want to send to an audience that includes more than one Salesforce report, create a separate Emma group to correspond with each of the Salesforce reports and select to send to all of those groups when sending your mailing.

How to refresh a group

If you created an Emma group with a report, the Emma group doesn't automatically update as you refresh the report data in Salesforce. Similar to the traditional import process within your Emma account, the leads or contacts pulled in to a report will only be sent to an Emma group when you go through the steps to add them. There isn't a persisting tie between the report and the Emma group.

If you refresh a report and would like to update the membership within your existing Emma group to match the refreshed report data, you’ll want to use the refresh group members feature. That feature updates the group membership to match the refreshed data in the report you originally used to populate the Emma group in Salesforce, removing any leads / contacts that are no longer included in the updated report data.

1. Open the existing Emma Group in Salesforce.
2. Click on the Refresh group members button.

How to delete a group

Go to the group that you want to delete from within the Emma Groups tab and click on the Delete button.

Please note: Due to the two-way nature of the sync in the integration, deleting a synced group in Salesforce will delete the corresponding group in Emma.

Triggering automated emails

Emma’s automation feature lets you trigger email sends based on many different criteria, including the ability to trigger sends based on fields changing in Emma. With the Emma for Salesforce integration, you can trigger those emails based on field changes that happen in Salesforce as well. Here’s how it works:

1. During the syncing process, make sure that you map the Salesforce field that you’d like to use for your trigger to a corresponding member field in Emma.
2. In Emma, set up an automated email based on that field changing in Emma. Learn more about field change automation triggers here.
3. That’s it! From now on, when the values for this field change in Salesforce, they’ll be updated in Emma and your automated workflows will fire appropriately.