Marketo Static Lists is a Marketo feature that lets you automatically group your Marketo records.
Getting started
RudderStack supports sending event data to Marketo Static Lists via the following connection modes:
Connection Mode | Web | Mobile | Server |
---|---|---|---|
Device mode | - | - | - |
Cloud mode | Supported | Supported | Supported |
Once you have confirmed that the source platform supports sending events to Marketo Static Lists, follow these steps:
- From your RudderStack dashboard, add the source. Then, from the list of destinations, select Marketo Static Lists.
- 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.
- 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.
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 property | Static Lists property | Notes |
---|---|---|
properties.listData.add[x].id Required | id | IDs to be added to the list. |
properties.listData.remove[x].id Required | id | IDs to be removed from the list. |
context.externalId.marketoStaticListId | listId | If 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:
- Log into your Marketo instance.
- Go to Admin > Integration > Munchkin.
Your Munchkin ID is listed on the main screen in the Tracking Code section, as shown:
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:
- Log into your Marketo instance and click the Admin tab.
- Select LaunchPoint.
- Here, you will able to see all the installed services used for connecting to Marketo.
- To create a new service, click New > New Service.
- Enter the Display Name. From the Service dropdown, select Custom.
- Under Settings, enter the Description and select the API Only User, as shown. Finally, click CREATE.
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.
Where can I find the Marketo static list ID?
To get your Marketo static list ID, follow these steps:
- Log into your Marketo instance.
- Go to the Database tab.
- Create a new static list. For more information, refer to the Marketo documentation.
- Open the static list. You can find the list ID in the resulting URL, as shown:
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.