Start tracking your progress
Trailhead Home
Trailhead Home

Finish the Marketing Cloud Connect Configuration

Learning Objectives

After completing this unit, you’ll be able to:

  • Configure the Marketing Cloud connection to the Salesforce CRM org.
  • Configure the Salesforce CRM org’s connection to the Marketing Cloud account.

Now that you’ve installed the managed package in the Salesforce CRM org, it’s time to go through some additional configuration steps in both environments to complete the setup.

Configure the Marketing Cloud Connection

Connect your Marketing Cloud account to the corresponding Sales or Service Cloud org at the account level to continue the Marketing Cloud Connect setup.



Before you begin this process, log out of Salesforce. (Merely closing the tab doesn’t log you out.) This is to prevent an incorrect connection, because during the process, the system would automatically connect to any active Salesforce session, which we don’t want.

  1. Log in to Marketing Cloud.
  2. Hover over your username and select Setup.
  3. Click Apps and select Salesforce Integration.
  4. Make sure Scope by User is deselected.
  5. Click Connect Account.
  6. Click OK to acknowledge the popup window.
  7. A login page displays in a new window. Enter the username and password for the Salesforce System User that you created in the last unit. If you are using a custom domain, select Use Custom Domain and enter the domain address before entering the Salesforce System User credentials.
  8. Click Allow to grant access for the Marketing Cloud API user to access the CRM org.

Configure the Connected App Settings in Salesforce CRM

We just connected from Marketing Cloud to the CRM org. That established a connected app relationship inside Salesforce CRM. Now we need to log back in to the CRM org and make a few updates to the connected app settings. Make sure a system admin performs the following steps in the CRM org.

  1. In Setup, type Connected Apps in the Quick Find box and click Connected Apps.

Quick Find box with Connected Apps selected

  1. Click Salesforce Marketing Cloud.
  2. Click Edit Policies.
  3. Under Permitted Users, select Admin approved users are pre-authorized.
  4. If a warning message appears, click OK.
  5. Under IP Relaxation, select Relax IP restrictions.
  6. Under Refresh Token Policy, select Immediately expire refresh token.
  7. Click Save.
  8. Scroll down the page and click Manage Permission Sets.
  9. Select the Marketing Cloud Connected App permission set that you created in the previous unit.
  10. Click Save.

You can stay logged in to the Salesforce CRM org for now. You will be returning to it shortly for some further configuration steps.

Create and Configure the Marketing Cloud API User

Just like in the CRM system, Marketing Cloud requires a user account for its connection to the CRM environment. It’s a best practice to dedicate a user license solely for this purpose. Here’s how to set up your Marketing Cloud API User.

  1. In Marketing Cloud, hover over your username and select Setup.
  2. Click Users in the menu and select Users.
  3. Click Create.
  4. Enter your email address for the Reply Email and Notification Email Address.
  5. Enter a unique username. We suggest MC-SF-API-User.
  6. Leave the External Key field blank, unless your organization requires it.
  7. Select a Time Zone.
  8. Select a Culture Code.
  9. Select API User.
  10. Create a temporary password.
  11. Click Save.

Finalize the Marketing Cloud API User setup by assigning roles.

  1. Click Users in the menu and select Users.
  2. Select the checkbox next to the Marketing Cloud API User you just created.
  3. Click Manage Roles.
  4. Click Edit Roles.
  5. Assign the following roles:
    • Administrator
    • Marketing Cloud Administrator
  6. Click Save.
  7. Log out of the Marketing Cloud environment and immediately log back in with the Marketing Cloud API User credentials you just created.

Complete the Managed Package Configuration

Now it’s time to head back over to the CRM org to finish the Managed Package configuration. The admin performs the following steps in the CRM org.

  1. In Setup, type Process Automation in the Quick Find box and select Process Automation Settings.

Quick Find box with process automation entered, and the Process Automation Settings setup node selected

  1. If the Default Workflow User is empty, click Lookup Icon and specify a user with System Administrator permissions to be the default workflow user. We suggest using the Salesforce System User account you created in the previous unit for this.
  2. Click Save.
  3. In Setup, type Session Settings in the Quick Find box and click Session Settings.

Quick Find box with session settings entered and the Session Settings menu option selected

  1. Scroll to the bottom of the page and click Save.

Yes, that’s right: You don’t actually change any settings, but this is a necessary step for the configuration.

  1. Click + Icon to navigate to the All Tabs screen.
  2. Click Marketing Cloud.
  3. Click Verify Remote Site.

Remote Site Verification dialog box with Verify Remote Site button highlighted

  1. Click Okay.
  2. Click Start Wizard to begin the setup wizard.

Marketing Cloud Connect Setup with Start Wizard button highlighted

  1. The next screen is a prompt for the Default Workflow User you created earlier. Click Next.
  2. Click Next to move forward and acknowledge you’ve saved the Session Security Settings.
  3. Click Next to acknowledge Field-Level Security information.
  4. Click Done to acknowledge the page layout update information.
  5. At the main Marketing Cloud Connector Setup screen, select I agree to acknowledge the automated changes that the wizard will perform, then click Configure Marketing Cloud Connector.
  6. If all goes well, you are rewarded with a configuration summary.

Marketing Cloud Connect Configuration Summary, announcing that the configuration was successful

  1. Click Okay! to finish the setup wizard.

Connect to Marketing Cloud Within Salesforce CRM

Now that you’ve finished the managed package configuration, it’s time to actually connect to Marketing Cloud from CRM and configure settings for the integration. 



Make sure you are logged out of the Marketing Cloud before completing this section. Merely closing the tab does not log you out.

  1. Click + Icon to navigate to the All Tabs screen.
  2. Click Marketing Cloud.
  3. Click Connect to Marketing Cloud.
  4. Enter the username and password for the Marketing Cloud API User. Click Login.
  5. If you’re successful, you see a screen to configure Marketing Cloud Connect settings. Under the Account section on the page, select Email.
  6. In the Sends section, select all options.
  7. In the Notifications section, enter the appropriate email address to receive any error messages from Marketing Cloud Connect.
  8. In the Tracking section, select appropriate options for your organization about the specific email tracking data that Marketing Cloud sends to the CRM system. Keep in mind that the choices you make for these can affect the overall storage of your CRM org.
  9. Leave the defaults for the rest of the settings and finish by clicking Save Settings.
  10. Select at least one business unit from the Business Unit Management screen and click Save.


Once you’ve finished and tested the initial configuration, it’s a good idea to learn all about these settings and adjust them if necessary for your organization. See the Resources for details on what these settings mean and their potential impact on your implementation. 

Marketing Cloud User Integration

With the connection established in the CRM System, we can now finish the Marketing Cloud user integration.

  1. In the Marketing Cloud, hover over your name and select Setup.
  2. Hover over Account and select Users.
  3. Click the name of the Marketing Cloud API User.
  4. Click Integrate in the Status field on the user general settings screen.  User General Settings screen with Integrate link highlighted
  5. Enter the username for the Salesforce System user and click Save Settings. Integration setup with username field populated

If you’re successful, the Status is Integrated.

Create Basic Field Mapping

We’re almost finished! One of the coolest features of Marketing Cloud Connect is its automatic synchronization of data between Marketing Cloud and Salesforce CRM. To make this work, we need to configure some basic field mapping. We specify the relationships between subscribers in Marketing Cloud and the corresponding fields in the Lead and Contact objects in Salesforce CRM. 

  1. Log in to Marketing Cloud with the Marketing Cloud API User credentials.
  2. In Marketing Cloud, hover over Email Studio and click Email.
  3. Hover over Subscribers and select Profile Management.
  4. Click Create.
  5. On the General tab, type First Name in the top text box.

New Attribute Properties screen with First Name entered on the General Tab

  1. Click the Salesforce tab.
  2. Select First Name in the Map to Salesforce Lead Field picklist.
  3. Scroll down in the Map to Salesforce Contact/Account Field picklist to the Contact General section and select First Name. Select both checkboxes to display on Salesforce Profile Center.

Configured Salesforce tab in the New Attribute Properties screen.

  1. Click OK.
  2. Repeat steps 3–9 to create a second attribute, substituting Last Name for First Name.

Congratulations—you did it! Marketing Cloud Connect setup is now complete. In the next unit we run through a scenario to test the connection and make sure everything is working properly.