---
title: Marketo connector (CMS 12)
slug: cms-12/docs/marketo-connector-cms-12
docTags: 
createdAt: 2026-08-10T15:55:53.000Z
---

:::hint{type="info"}
**Note**

The [Optimizely Digital Experience Platform (DXP)](https://www.episerver.com/products/dxp) contains many features to support you in your daily work. Depending on how your solution is set up, some features described in this documentation may not be available.
:::

The Marketo® connector add-on automatically exports form data from your website to your Marketo account database by mapping Optimizely form fields to Marketo database fields. For information about other database connector add-ons, see [Marketing Automation](docId\:lw3KOQMT4bS88DycCZNow).

## Set up Optimizely forms with Marketo

The Forms Marketing Automation Integration (MAI) connector lets you connect [Optimizely form fields](docId\:KVnsZDpxrq5wlYjBejT3W) to a Marketo database. See also [Marketing Automation](docId\:lw3KOQMT4bS88DycCZNow).

:::hint{type="info"}
**Note**

A developer must install the Forms Marketing Automation connector and the Marketo connector.
:::

1. In the app selector, select **Addons > Marketing Automation**.
2. Click **Create**. The **Add connector** view displays.

   ![Add Marketo connector](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/Fln7KgGbaX_Wam9ofPcDc-20260720-145635.png)
3. Select **Marketo** from the list of available connectors. The Marketo configuration settings screen displays.

   ![Marketo configuration settings screen](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/AoDEp9yQJPzIEcaXYkaHv-20260720-145635.png)

   :::hint{type="info"}
   **Note**

   You can have multiple instances of the same connector. For example, if you have marketing teams in separate regions, you can have more than one Marketo connector, such as Marketo - Europe, Marketo - US, and Marketo - APAC.
   :::
4. Enter the **Connector Name**, **Endpoint URL**, **Client ID**, and **Client secret** associated with your Marketo account.
5. Optional: Specify a list of **Workspaces** that filter lists fetched from Marketo and displayed in the **Data sources** drop-down list on the form **Mappings** tab. If no value is specified, all the lists are fetched.
6. For **Multiple submissions in same session**, select **Create new entity** or **Update previously created entity**.
7. Click **Save**.
8. [Create a form](docId\:SR3I1aAJbh0TU85e6pNQk) on a page.
9. Click **All Properties** on the form.
10. Open the **Mappings** tab.
11. Select the database to which you map the form fields from the **MA System Database** drop-down field. (Each database in the list can have different fields.)
12. Click **Publish**.
13. On the form, select **Edit** from a form field's context menu.
14. Open the **Extra field mappings** tab. The database option that you selected earlier displays.
15. Enable the database option and open the associated drop-down list to see the available fields. For example, if your form has a [Text](docId\:dGqSQKV0mgM33Efyrw9v5) field that was configured to capture an email address:

    1. Edit the email text field.
    2. Select the **Extra field mappings** tab.
    3. Select **Lead** from the drop-down list to map the Marketo database field to the **Email** field on the form.

    ![Mapping a Marketo database field to a form field](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/VZujGA-bxCxts_bd551Ar-20260720-145635.png "Mapping a Marketo database field to a form field")
16. Repeat steps 13 through 15 for as many fields as you want to map.
17. Click **Publish**.

To test the mapping, go to your form on a published page, fill in and submit the form, and then go to your Digital Experience Hub (DXH) connector provider to verify that the user is added to the appropriate database (Marketo Leads).

### Associate a lead to a campaign

To associate a lead to a campaign:

1. Add a [Hidden Predefined value](docId\:iuBeFWU1XVa80qHBgxw9i) field to your form and use the campaign ID as the Predefined value.

   ![Add Hidden predefined value](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/v3aReH4TAG2Al1HbNdVB8-20260720-145635.png "Add Hidden predefined value")
2. Map the value to the **Marketo-Campaign\_Id** on the **Extra field mappings** tab.

   ![Map value in Extra field mappings tab](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/SNiBRmZXJx8YZYBN89Q0M-20260720-145635.png "Map value in Extra field mappings tab")

## Retrieve contact data

When a visitor submits the form, the data is sent to the Marketo database. To see who submitted the form, go to **Marketo** > **Lead Database** > **All Leads** and select the contact list.

## Personalize the form using a block

You can personalize and target messages based on profile information collected through the Marketo integration. You can apply personalization to forms and blocks. Mailings are managed within Marketo.

Video tutorial: [Personalizing content with Optimizely and Marketo.](https://episerver.wistia.com/medias/ynncd0tul2) (2:56 minutes) See also [Set up audiences with personalization](https://support.optimizely.com/hc/en-us/articles/4413192423053).

You can personalize a form to show only to a selected group. For information about creating a visitor group and displaying information based on a visitor group, see [Audiences](docId\:rodC2wlhTnWSmd-DJR2_y).

1. From the context menu on the form on the page, select **Personalize**. The **Large content area** dialog box displays.

   ![Marketo connector form, Personalize](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/DRvxC8hWF30dqKQiFhuFq-20260720-145635.png "Marketo connector form, Personalize")
2. Click **Everyone** and select a visitor group from the list. The following image shows personalizing the form to show only for people in the *VIP* visitor group.

   ![Marketo connector form, personalized group](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/6_5X7JFqEvYvpDR_TuBg8-20260720-145635.png "Marketo connector form, personalized group")

To create a visitor group for a Marketo form, see [Create a visitor group for an MAI connector form](docId:0TrCDHzFBFPQnvrRj-Vka).
