Skip to main content
Loading...
Skip to article
  • Qualtrics Platform
    Qualtrics Platform
  • Customer Journey Optimizer
    Customer Journey Optimizer
  • XM Discover
    XM Discover
  • Qualtrics Social Connect
    Qualtrics Social Connect

Marketo Task


Was this helpful?


This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!


Qtip: The Marketo extension is an additional purchase for your Qualtrics license. If you do not have access and are interested, you can purchase this solution from the XM Marketplace.

About Marketo Tasks

The Marketo task allows you to pass data from Qualtrics to Marketo. You can use this data to create or update a Marketo Lead, or create one or more Marketo activities. Custom activities can be used inside Marketo to filter data or create triggers. When setting up this task, you can select one of three options:

  • Create a Marketo activity: Link a single activity to your task to create one activity for every response a lead takes. This means that you can pick and choose which response fields you want to pass to Marketo as attributes for the activity.
  • Create multiple Marketo activities: Link multiple activities to your task to create multiple activities for every response a lead takes. For this task, every data point connected to a response will count as a new activity.
  • Create or update a Marketo lead: Link a survey response to a new or existing Marketo lead. After the lead is created, you will have a Lead ID that you can use in subsequent Create a Marketo activity or Create multiple Marketo activities tasks.

Marketo Configuration

There are a few actions will you have to take in your Marketo account before you can use this extension.

  1. Create custom activities you want to map Qualtrics fields to.
  2. Create an API user and role to use for the Marketo extension. Be sure to give the user and role permission to create and update activities.
  3. Get the Client ID, Client Secret, and Munchkin ID of your instance.

See the Marketo Extension Overview for more on setting your Marketo account.

Qtip: Qualtrics Support can help with the setup of the Marketo extension on the Qualtrics side. However, for help troubleshooting actions inside your Marketo account, we recommend reaching out to Marketo’s support team.

Marketo Task Initial Setup

Once you have gotten your Marketo account ready, it’s time to begin setting up the Marketo task in Qualtrics. This section will cover the initial setup for connecting a Marketo account and selecting your desired task in Marketo.

  1. In your survey, go to the Workflows tab.
    In the workflows tab, clicking "create a workflows" and then "started when an event is received"
  2. Click Create a workflow.
  3. Select Started when an event is received.
  4. Define the Event that will trigger the workflow in Marketo. Most of the time, this will be a Survey Response from Qualtrics.
    choosing the survey event, adding conditions, and choosing the task
  5. If desired, click the plus sign ( + ) and then Conditions to set conditions under which the workflow is triggered.
    Qtip: This is most helpful if you don’t want custom activities created in Marketo every time a response is submitted to the survey.
  6. Click the plus sign ( + ) and then Task.
  7. Select Marketo.
    selecting the marketo task in the task window
  8. Choose the task you want to perform in Marketo.
    choosing the marketo task to perform
    Your options include:

  9. Click Next.
  10. Choose a Marketo account to connect to. You’ll be able to select any previously connected accounts, as well as accounts connected by Brand Administrators for brand use.
    choosing an account or adding a new one
  11. To connect a new account, click Add user account.
    Qtip: After clicking Add user account, give your account a name to identify it. Then, add your Client ID and Client Secret.
    adding a new marketo account
    Qtip: Your Client ID and Client Secret can be found by going to Admin and then Launchpoint in Marketo. Once there, click View Details next to your service.
    the client id and client secret fields in marketo
  12. Click Next.
  13. Enter your Munchkin ID.
    entering a munchkin id and clicking verify

    Qtip: The Munchkin ID is the first 11 characters in your identity URL on Marketo.
  14. Click Verify.
  15. The remainder of the task setup will depend on the option you selected in step 8. Visit the linked sections for more information:

Create a Marketo Activity

Linking a single activity will create one Marketo activity for every survey response a lead takes. With this option, you can pick and choose which response fields you want to pass to Marketo as attributes for the activity.

  1. Follow the steps in the Marketo Task Initial Setup  section and choose Create a Marketo Activity as your task.
  2. Use the Select activity dropdown to choose a custom activity.
    creating a marketo activity task

    Qtip: The activities available in this dropdown are dependent on what custom activities you have set up in Marketo. See Marketo’s documentation on activities for assistance.
    Attention: If you do not see any activities in the activity dropdown, you may have entered the wrong credentials. If you are using the correct credentials, then you may need to adjust the permissions granted for the user or role in Marketo. See Marketo Configuration for more information.
  3. Enter the Lead ID field by clicking the piped text icon, {a}, and selecting the embedded data field that corresponds to Lead ID. This may come from external embedded data saved in a mailing list, or data passed from previous tasks.
    Qtip: For the responses to be pushed to Marketo, every response should have a Lead ID, since custom activities are connected to leads in Marketo.
    Example: You can use the Create or update a Marketo Lead task to first create or update a lead in Marketo, which will make the Lead ID an available field in Qualtrics. Then, use the Create a Marketo activity task to insert an activity. The piped text menu will contain the Lead ID to pipe in.
  4. Map your activity’s primary attribute, which is required. In this case, it’s the response’s unique ID, so we’ve selected the piped text for Response ID.
  5. To add additional fields, click Add a field and then choose the Marketo field and the Qualtrics source field. For your source fields, click the piped text icon, {a}, and choose the Qualtrics field to use. The fields available in this menu will depend on your selected event. If you chose a survey response event, your options are:
    • Survey Question: The respondent’s answer to a survey question.
    • Embedded Data Field: An embedded data field.
    • GeoIP Location: The postal code, city, state / region, area code, or country name for the response based on GeoIP data.
    • DateTime: The current datetime, or a datetime relative to the current datetime
    • Panel Field: The respondent’s first name, last name, email, external data reference, and language, if saved in a mailing list.
    • Quota: Indicates if the response incremented a survey quota.
    • Response: The responses’ ID and response link.
    • Status: The response’s status.
  6. To remove a field, click the minus sign ( ) next to the field.
  7. Click Save to finish.
Qtip: To test the Marketo task, take a survey response. Then verify that your response has an expected leadId in embedded data you’ve designated as the leadId field. Then login to Marketo and verify that the activities are created.

Create Multiple Marketo Activities

Attention: The “Create multiple Marketo activities” functionality will be deprecated in the near future. Instead, you can create multiple Marketo tasks with the Create a Marketo activity option.
Attention: You can only create multiple Marketo activities with the survey response event.

If you link multiple Marketo activities to an event in Qualtrics, every data point connected to a response will count as a new activity. This includes all question fields and embedded data connected to the response.

  1. Follow the steps in the Marketo Task Initial Setup  section and choose Create a Marketo Activity as your task.
  2. Use the Select activity dropdown to choose a custom activity.
    creating a multiple activity marketo task

    Qtip: The activities available in this dropdown are dependent on what custom activities you have set up in Marketo. See Marketo’s documentation on activities for assistance.
    Attention: If you do not see any activities in the activity dropdown, you may have entered the wrong credentials. If you are using the correct credentials, then you may need to adjust the permissions granted for the user or role in Marketo.
  3. Enter the Lead ID field by clicking the piped text icon, {a}, and selecting the embedded data field that corresponds to Lead ID. This may come from external embedded data saved in a mailing list, or data passed from previous tasks.
    Qtip: For the responses to be pushed to Marketo, every response should have a Lead ID, since custom activities are connected to leads in Marketo.
    Example: You can use the Create or update a Marketo Lead task to first create or update a lead in Marketo, which will make the Lead ID an available field in Qualtrics. Then, use the Create a Marketo activity task to insert an activity. The piped text menu will contain the Lead ID to pipe in.
  4. Map your activity’s primary attribute, which is required. In this case, it’s the response’s unique ID, so we’ve selected the field Response ID.
  5. To add additional fields, click Add a field and then choose the Marketo field and the Qualtrics source field. For your source fields, you may choose from a list of predefined Qualtrics attributes:
    • SurveyID: Unique ID of the Qualtrics survey you are setting the task on.
    • ResponseID: Qualtrics-defined ID of the response.
    • QuestionID: Qualtrics-defined ID for questions in your survey.
    • ExportTag: Tag used to identify questions in your survey. The user can edit these. See Export Tags.
    • ChoiceText: Text for the choices that the respondent selected. Also known as Variable Names.
    • ChoiceRecode: Recode values for the choices that the respondent selected.
    • EmbeddedDataField: User defined Embedded Data field name.
    • EmbeddedDataValue: Embedded Data field value.
      Example: Here’s what your mapping will look like if you add every field available:
      an example field mapping with each marketo field corresponding to a source field
  6. To remove a field, click the minus sign ( ) next to the field.
  7. When finished, click Save.
Qtip: To test the Marketo Task, take a survey response. Then verify that your response has an expected leadId in embedded data you’ve designated as the leadId field. Then login to Marketo and verify that the activities are created.

Create or Update a Marketo Lead

Creating or updating a lead in Marketo allows you to take Qualtrics event data, like a survey response, and create a new lead in Marketo with this information or update the lead with new information. As part of a successful create or update, the lead ID will then be returned which can be used with the Create a Marketo activity or Create multiple Marketo activities task.

  1. Follow the steps in the Marketo Task Initial Setup section and choose Create a Marketo Activity as your task.
  2. Select the Event type for creating or updating the lead. Each option will change the  task setup slightly.
    choosing an event type from the dropdown menu

    • Create or update a lead: Will attempt to find the lead in Marketo first and update the mapped fields to that user. If the lead is not found, a new lead is created with the mapped fields.
    • Create only: Will try to create a new lead in Marketo. If the lead already exists, Marketo will return an error.
    • Update only: Will try to update an existing lead in Marketo. If the lead doesn’t exist, marketo will return an error.
  3. If you selected “Create only,” then skip this step since you are creating a new lead. If you selected “Create or update a lead” or “Update only”, you will need to select a lookup field to search for the lead in Marketo. Use the What to search dropdown to select a field.
    choosing a field to search

    Qtip: The fields you can search will typically be a subset of all lead fields. These are considered searchable fields. See more information on searchable fields on this Marketo support page.
  4. If you selected “Create only,” then skip this step since you are creating a new lead. If you selected ‘Create or Update a lead’ or ‘Update Only’, you will need to map the field selected as a required field. This field is used to identify if the lead already exists in Marketo. Use the piped text icon, {a}, to select a field from Qualtrics.
    using the piped text menu to select a field
  5. To add additional fields, click Add a field and then choose the Marketo field and the Qualtrics source field. For your source fields, click the piped text icon, {a}, and choose the Qualtrics field to use. The fields available in this menu will depend on your selected event. If you chose a survey response event, your options are:
    mapping additional fields and saving

    • Survey Question: The respondent’s answer to a survey question.
    • Embedded Data Field: An embedded data field.
    • GeoIP Location: The postal code, city, state / region, area code, or country name for the response based on GeoIP data.
    • DateTime: The current datetime, or a datetime relative to the current datetime
    • Panel Field: The respondent’s first name, last name, email, external data reference, and language, if saved in a mailing list.
    • Quota: Indicates if the response incremented a survey quota.
    • Response: The responses’ ID and response link.
    • Status: The response’s status.
  6. To remove a field, click the minus sign ( ) next to the field.
  7. Click Save to finish
Qtip: You can begin your workflow with a “Create or Update a Marketo lead” task to generate the Lead ID of your Marketo leads. Then in the following task, such as ‘Create a Marketo activity’, you can select the Lead ID in the piped text menu.

FAQs