Marketo Static Lists is a Marketo feature that lets you automatically group your Marketo records.

Find the open source code for this destination in the GitHub repository.

Getting started

RudderStack supports sending event data to Marketo Static Lists via the following connection modes:

Connection ModeWebMobileServer
Device mode---
Cloud modeSupportedSupportedSupported

Once you have confirmed that the source platform supports sending events to Marketo Static Lists, follow these steps:

  1. From your RudderStack dashboard, add the source. Then, from the list of destinations, select Marketo Static Lists.
  2. Assign a name to the destination and click Continue.

Connection settings

To successfully configure Marketo Static Lists as a destination in RudderStack, you need to configure the following settings:

  • Munchkin Account ID: Enter your Munchkin account ID. For more information on obtaining your Munchkin ID, refer to the FAQ section below.
  • Client ID: Enter your Marketo client ID.
  • Client Secret: Enter the associated client secret for the above client ID.
For more information on obtaining your Marketo client ID and secret, refer to the FAQ section below.
  • Static List ID: Enter your Marketo static list ID. RudderStack uses this ID to add or remove leads from the specific list. For more information on obtaining your static list ID, refer to the FAQ section below.
RudderStack prioritizes the marketoStaticListId provided in the event's externalId over the Static List ID dashboard setting. If marketoStaticListId is absent in externalId, RudderStack looks for the static list ID in this setting, as it is mandatory to send event data successfully to Marketo.

audienceList structure

You can add or remove users to a Marketo static list via the audienceList calls.

The following code snippet shows a sample audienceList call:

{
"userId": "1hKOm4GRlm",
"anonymousId": "anon-id-new",
"type": "audiencelist",
"properties": {
"listData": {
"add": [{
"id": 123
},
{
"id": 234
}
],
"remove": [{
"id": 456
},
{
"id": 567
}
]
}
},
"context": {
"ip": "14.5.67.21",
"library": {
"name": "http"
},
"externalId": [{
"type": "marketoStaticListId",
"id": 1234
}]
}
}

RudderStack transforms this data and sends it to Market Static Lists in the required format.

Supported mappings

The following table details the mapping of the RudderStack audienceList properties and Marketo Static Lists properties:

RudderStack propertyStatic Lists propertyNotes
properties.listData.add[x].id
Required
idIDs to be added to the list.
properties.listData.remove[x].id
Required
idIDs to be removed from the list.
context.externalId.marketoStaticListIdlistIdIf specified, takes precedence over the Static List ID dashboard setting.

FAQ

Where can I find my Munchkin account ID?

To get your Munchkin account ID, follow these steps:

  1. Log into your Marketo instance.
  2. Go to Admin > Integration > Munchkin.

Your Munchkin ID is listed on the main screen in the Tracking Code section, as shown:

Marketo Munchkin ID
For more information, refer to the Marketo documentation.

How do I obtain the Marketo client ID and secret?

To set up the Marketo API service and obtain the client ID and secret associated with it, follow these steps:

  1. Log into your Marketo instance and click the Admin tab.
  2. Select LaunchPoint.
marketo launchpoint
  1. Here, you will able to see all the installed services used for connecting to Marketo.
marketo services
  1. To create a new service, click New > New Service.
  2. Enter the Display Name. From the Service dropdown, select Custom.
  3. Under Settings, enter the Description and select the API Only User, as shown. Finally, click CREATE.
marketo services
Make sure the API Only User associated with the API service has the necessary permissions to create or update contacts as well as the custom activities.

Once the setup is complete, you should have the client ID and client secret for the API service. Use this to configure the Marketo destination in RudderStack.

marketo service details

Where can I find the Marketo static list ID?

To get your Marketo static list ID, follow these steps:

  1. Log into your Marketo instance.
  2. Go to the Database tab.
  3. Create a new static list. For more information, refer to the Marketo documentation.
  4. Open the static list. You can find the list ID in the resulting URL, as shown:
Marketo static list ID

For example, if the static list URL is https://engage-ab.marketo.com/?munchkinId=123-AXP-456#/classic/ST1234A1, then the static list ID is 1234.


Contact us

For more information on the topics covered on this page, email us or start a conversation in our Slack community.

On this page