5 minute read

Installation and Setup

  • Installation and setup is quick, easy and largely wizard driven.

  • A separate Emma account is required, if you don't have one click here to sign up.

  • We support both the Salesforce Classic and Lighting user interfaces and the not for profit success pack.

  • You can install into your Salesforce production, sandbox or developer orgs.

  • Once installed you get a free 14 day trial unless you are in a sandbox of developer account which provides a longer trial.

  • The integration works with all Emma plans and the following Salesforce editions:

    • Professional
    • Enterprise
    • Performance
    • Unlimited

If you are new to Emma please ensure you are set up correctly before you start the installation. If you have questions about Emma, please reach out to them directly. See: https://myemma.com/


All Salesforce applications are installed via a standard wizard using the steps below:
  1. Go to our Salesforce AppExchange listing.

  2. Click the Get it now Button.

  3. If you are not already logged in you will be prompted to do so.

  4. Choose whether to Install in Production or a Sandbox.

  5. Select I have read and agree to the terms and conditions, then click Confirm and Install.

  6. Choose whether to install for admins only, all users or specific profiles.  We recommend you select Admins only and once installed give users access via our permission sets.

  7. Click Install.

  8. Select Yes, grant access to these third-party websites then click Continue.

  9. Generate your Emma API keys. See: How to generate your API keys.

It usually takes Salesforce less than 10 minutes to install, once complete you will receive a confirmation email.

Emma API keys

Before you begin, ensure you have your Emma account/subaccount API details. To get them, please log in to Emma (if you’re an Emma HQ user, you’ll need to make sure you’re accessing the subaccount you’ll be connecting). Then choose ‘profile’ or ‘your settings’ from the dropdown menu by your username. From here, you can select the “API key” tab to generate a new set of keys. If you’ve generated them before, Emma will never retain your private key, so you’ll need to either locate where these were recorded outside of Emma or generate a new set.

To connect the integration, you’ll need your:

1. Account ID
2. Public key
3. Private key

See: How to generate your API keys.

Setup (connecting to Emma)

After installing Emma for Salesforce, follow the steps below to setup and connect your Emma account:

  1. In Salesforce, click the app menu/launcher select Emma admin.

  2. Click the Emma settings tab.

  3. Click Connect, enter your Emma API details.

  4. When the connection is made you will see on screen Confirmation.

  5. If you wish to view email tracking history on either a contact or lead record you need to add a component. This depends on what Salesforce user interface you are using, below are videos for both using a contact as an example however it is the same process for the lead object.

The setup wizard will now automatically setup page layouts and enable the sync. The primary sync (this pulls information from Emma) will run every hour.  These settings can be changed via the Emma Settings Tab on the Sync screen.

You can connect multiple Emma accounts to the same Salesforce org (the Emma accounts can be completely unrelated - the connection is based on the Emma API keys).

Custom Salesforce objects

After installing Emma for Salesforce, the following custom objects will be created. These objects contain either records or settings required for our application. Our product has been designed to be self contained in order to not impact standard objects.

  • Emma account.
  • Emma audience.
  • Emma group.
  • Queue item.
  • Emma mailing.
  • Field mapping.
  • Emma account user.
  • Subscriber import.

Our object structure should not be customised as it may stop our application working correctly or stop automated upgrades.

Next Steps

Below are two articles that are recommended reading and the best next steps.


How do I manually update page layouts?

In this article