---
title: Eloqua connector (CMS 11)
slug: cms-12/docs/eloqua-connector-cms-11
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 Eloqua connector add-on automatically exports form data from your website to your Eloqua account database by mapping Optimizely form fields to Eloqua database fields. For information about other database connector add-ons, see [Marketing Automation](docId\:lw3KOQMT4bS88DycCZNow).

## Set up Optimizely forms with Eloqua

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

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

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

1. In the Optimizely Content Management System (CMS) admin view, select **Config** > **Tool Settings** > **Eloqua**. The Eloqua configuration settings screen displays.

   ![Eloqua settings](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/h3AU-blrGlHRpfzJZ2LWn-20260720-145632.png "Eloqua settings")

   :::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 Eloqua connector, such as *Eloqua - Europe*, *Eloqua - US*, and *Eloqua - APAC*. Click **Add Connector** to add another instance.
   :::
2. Enter your Eloqua account's username, password, and company name, and click **Save**.

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

   Select **Enable OAuth2 Authentication** if you want to authenticate the Eloqua API using OAuth2.
   :::
3. [Create a form](docId\:SR3I1aAJbh0TU85e6pNQk) on a page.
4. Click **All Properties** on the form.
5. Open the **Mappings** tab.
6. Select the **Contacts** database to which you map the form fields from the **MA System Database** drop-down field.

   ![Selecting the Eloqua database](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/EUJwII0DzrRymMO2KofUC-20260720-145632.png "Selecting the Eloqua database")
7. Click **Publish**.
8. On the form, select **Edit** from a form field's context menu.
9. Open the **Extra field mappings** tab. The database option that you selected earlier displays.
10. 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 **emailAddress** from the drop-down list to map the Eloqua database field to the **Email** field on the form.

    ![Mapping an Eloqua database field to form field](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/leFp_DdZ4h5_e9wB-uzXM-20260720-145632.png "Mapping an Eloqua database field to form field")
11. Repeat steps 8 through 10 for as many fields as you want to map.
12. 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 Eloqua provider to verify that the user is added to the Eloqua database.

## Retrieve contact data

When a visitor submits the form, the data is sent to Eloqua. To see who submitted the form, open the Contacts tab and select Contacts. You then can search using the search box in the top right corner. For more information, see [Search and view contact records](https://docs.oracle.com/cloud/latest/marketingcs_gs/OMCAA/Help/Contacts/Tasks/SearchingContacts.htm) on the Oracle website.

## Personalize the form using a block

Video tutorial: [Personalize content with Optimizely and the Eloqua database](https://episerver.wistia.com/medias/rwoebpuiim). (2:15 minutes)

You can personalize a form to show only to a selected group of people. For more 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 appears.

   ![Personalize form, part 1](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/zTjWdZR4rFp9YQJrtJFZN-20260720-145632.png "Personalize form, part 1")
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.

   ![Personalize form, part 2](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/CNoj_ZHST1r2jSQ5hKM5g-20260720-145632.png "Personalize form, part 2")

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