This document shows you, how to set up exports from Mapp Engage to Salesforce. This allows you to synchronize contacts and contact attributes.


Please note that this is an optional feature that has to be activated.

To proceed, you need an established connection to Salesforce.


  1. Go to the Setup page in your Salesforce account and search for App Manager.
  2. Click "New Connected App".

  3. Fill in the Basic Information fields.

  4. Go to API (Enable OAuth Settings).

    1. Activate the Enable OAuth Settings checkbox.
    2. Enter the Callback URL if you are using the standard cloud Salesforce instance.
    3. Activate Use digital signatures and Require Secret for Web Server Flow checkboxes.
    4. Select the following OAuth Scopes:
      1. Access and manage your data (api).
      2. Perform requests on your behalf at any time (refresh_token, offline_access).
    5. Leave the page open and continue with the next step.

  5. Upload digital signatures from the Mapp Connect integration. 

    1. Open Mapp Engage in a new browser tab and click Data Management > Mapp Connect.

    2. Open the Salesforce integration.

    3. Generate the key and then download it.

    4. Switch back to your Salesforce browser tab, Upload the generated key and Save the configuration. 

  6. Copy the Consumer Key from Salesforce to the Mapp Connect Salesforce integration.

  7. Save the setting in Mapp Engage.
  8. Add permissions in Salesforce.
    1. Go to Manage connected Apps.
    2. Choose the App and click Edit Policies

    3. Change Permitted Users to Admin approved users are pre-authorized and select Enable User Provisioning.

    4. Save your configuration.

  9. Click Manage Profiles on the Connected App settings page.

  10. Select Marketing user and save.

  11. Select or create an API user and set a Marketing role.
    1. Click in Setup view Administration > Users > Users.
    2. Create a new user (with the email that you have access to) or edit the existing user.
    3. Set a marketing role and license 'Salesforce' or add a marketing role and license 'Salesforce' to the user whose email will be pasted into the integration.

  12. Switch to Mapp Engage, add the email address as API user and save.

  13. In Mapp Engage, go to Audience > Groups.
  14. Open the group from which you to export data into Salesforce.
  15. In the Salesforce Integration section, select the integration from the drop-down list.
  16. Click Save. From now on, contacts that are added to this group, will be exported to Salesforce.

    This set up does not work retroactively, so any contacts that were already in this group before configuring the Salesforce integration, will not automatically be exported.

Next Step