ESP Sync for Marketo

Litmus ESP Sync for Marketo provides integration with a number of steps in the email workflow including Building, Testing, and Analyzing email performance.

Setting up the Marketo sync

Setting up Marketo requires four inputs to use as API credentials to your Marketo account. To authenticate, Litmus needs:

• Client Id 
• Client Secret 
• Identity URL 
• Endpoint URL

The first two come from creating an installed service, and the two URLs are copied from the REST API section of Marketo. Credentials can be entered from the Export menu in any Builder view, or from the Manage ESPs page in Settings.  You can also connect your ESP from the Analyze section to get Integrated Insights.  

Create the API role and API Only user in Marketo

You need to create a Custom Service to connect to Litmus and associate that service with an API Only User in Marketo. 

Use this quick start guide for Marketo REST API which shows how to set up a typical API service in Marketo. The first step is to set up an API role and then create an API user and give that role to the API user. 

Permissions needed for Litmus ESP integration

While you can grant all API permissions, Litmus only needs two permissions when creating the API role to use ESP Sync: 

• Read-Write Assets permissions to sync email designs.
• Read-Only Activity permissions to sync email performance activity to Litmus Integrated Insights.

Creating a new role

• Select the Users & Roles node on the left side of the Admin panel.
• Choose New Role to display the modal below.
• Select the permissions needed: Read-Write Assets and Read-Only Activity.

Create the custom service in Marketo

Once you have an API role and an API Only User set up, go to Admin > LaunchPoint.

Create a New Service and select Custom as the service type.

Once the service is created, get the Client Id and Client Secret by selecting your service and then View Details. In this example, we named the service Builder-Test.
 

Selecting View Details displays the necessary authentication details you'll need to provide to Litmus. You will need to paste the Client Id and Client Secret in the Litmus Connect ESP modal. 

Next, go to Admin > Web Services. Grab the Identity URL and Endpoint URL under the REST API section. You will need to paste these into the Litmus ESP modal in the next step. 

Enter the details in Litmus

You can now set up your connection to Marketo from the Settings Manage ESPs page in Litmus Settings or from the Integrated Insights Report in Litmus. 

• Select Add a new ESP or Connect ESP. 
• Follow the instructions to enter the details you copied from Marketo. You will need to enter your Identity URL, Endpoint URL, and the Client ID and Client Secret for the service you created.

Make sure there are no leading spaces in the details you have entered, as those can be copied over from the Marketo UI. Select Add & Authenticate ESP to complete the setup.

Your Litmus account should now be connected and ready to sync with Marketo.