How to use IBM App Connect with Marketo

Supported product and API versions

To find out which product and API versions this connector supports, see Detailed System Requirements on the IBM Support page.

Connecting to Marketo

Complete the connection fields that you see in the App Connect Designer Connect > Applications and APIs page (previously the Catalog page) or flow editor. If necessary, work with your Marketo administrator to obtain these values.

To obtain the connection values for Marketo, see Obtaining connection values for Marketo.

To connect to a Marketo endpoint from the App Connect Designer Applications and APIs page for the first time, expand Marketo, then click Connect. For more information, see Managing accounts.

What to consider first

Before you use App Connect with Marketo, take note of the following considerations.

• (General consideration) You can see lists of the trigger events and actions that are available on the Applications and APIs page of the App Connect Designer.

  For some applications, the events and actions depend on the environment and whether the connector supports configurable events and dynamic discovery of actions. If the application supports configurable events, you see a Show more configurable events link under the events list. If the application supports dynamic discovery of actions, you see a Show more link under the actions list.

• (General consideration) If you are using multiple accounts for an application, the set of fields that is displayed when you select an action for that application can vary for different accounts. In the flow editor, some applications always provide a curated set of static fields for an action. Other applications use dynamic discovery to retrieve the set of fields that are configured on the instance that you are connected to. For example, if you have two accounts for two instances of an application, the first account might use settings that are ready for immediate use. However, the second account might be configured with extra custom fields.
• If you want Marketo to trigger flows in App Connect, you also need to configure and activate a webhook in Marketo with the webhook callback URL that is provided by App Connect.
  Note: A webhook URL is associated with an account. Therefore, all flows that use that account have the same webhook URL and are triggered when an event occurs.
  To configure a webhook in Marketo for use with App Connect, use the following settings.
  • Set the URL to the value of the webhook callback URL that is provided on the Marketo event node in an App Connect flow. To get this value from App Connect, create an event-driven flow and add a Marketo event (for example, New Lead). Copy the Webhook callback URL value that is shown.

    • Example of a webhook callback URL in App Connect

      

  • In Payload Template, specify the fields of the Marketo object that you want to pass to other applications in the App Connect flow. For example, for the Marketo event New Lead, set the Payload Template with the following format:

    
    firstName={{Lead.First Name}}&lastName={{Lead.Last Name}}&email={{Lead.Email Address}}&company={{Company.Company Name}}&id={{lead.Id}}
    

  For more information, see How to configure and activate a Marketo webhook for use with App Connect.

Events and actions

Email events

These events are for changes in this application that trigger a flow to start completing the actions in the flow.

Marketo actions

Your flow completes these actions on this application.

Campaigns

Retrieve campaigns

Leads

Create lead

Update or create lead

Retrieve leads

Add lead to list

Delete lead

Update lead

Lists

Retrieve lists

Opportunities

Create opportunity

Update or create opportunity

Retrieve opportunities

Update opportunity

Delete Opportunity

Examples

Use templates to create flows for Marketo

Learn how to use App Connect templates to create flows that complete actions on Marketo. For example, go to the Discover page, then search for Marketo.

Learn more