---
title: Eloqua connector (CMS 12)
slug: cms-12/docs/eloqua-connector-cms-12
docTags: 
createdAt: 2026-08-10T15:55:56.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 app selector, select **Addons > Marketing Automation**.
2. Click **Create**. The **Add connector** view displays.

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

   ![Add Eloqua connector](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/YclR5paCNYLR6bi52KXlF-20260720-145618.png)

:::Paragraph{indent="1"}
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*.
:::

4. Enter the connector name, user name, password, company name, client ID, and client secret associated with your Eloqua account.

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

   Select **Enable OAuth2 Authentication** if you want to authenticate the Eloqua API using OAuth2.
   :::
5. [Create a form](docId\:SR3I1aAJbh0TU85e6pNQk) on a page.
6. Click **All Properties** on the form.
7. Open the **Mappings** tab.
8. 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/23_cOW2AMhS85UDU5TMYU-20260720-145618.png "Selecting the Eloqua database")
9. Click **Publish**.
10. On the form, select **Edit** from a form field's context menu.
11. Open the **Extra field mappings** tab. The database option that you selected earlier displays.
12. 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/lJmaCGEAc8-BapbmnGAfz-20260720-145618.png "Mapping an Eloqua database field to form field")
13. Repeat steps 10 through 12 for as many fields as you want to map.
14. 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 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) 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.

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