## Eloqua integration

Oracle Eloqua is a B2B marketing automation platform for campaigns, lead management, and customer data. Integrating Eloqua with Frontegg lets your application manage contacts, accounts, and contact lists, work with custom objects, forms, and external assets, and read emails, campaigns, and landing pages on behalf of your users — all through Frontegg's integration layer using Eloqua's OAuth 2.0 authorization.

Prerequisites
- An [Oracle Eloqua](https://www.oracle.com/cx/marketing/automation/) account
- Access to **Settings → AppCloud Developer** to register an app


### Connect Eloqua

You register an OAuth 2.0 app in Eloqua's AppCloud Developer area. The app provides the **Client ID** and **Client Secret** and defines the **callback URL** that Eloqua returns users to after they authorize access. You will also need your Eloqua **pod** — the data-center segment of your Eloqua host.

#### Step 1: Open AppCloud Developer

Sign in to Eloqua and go to **Settings → AppCloud Developer**, then click **Create New App**.

#### Step 2: Fill in the app details

Complete the app details: enter a **Name** (for example, `Frontegg Integration`), a **Description**, and optionally an icon.

#### Step 3: Set the OAuth callback URL

In the **OAuth** section, enter your Frontegg Redirect URL in the **OAuth Callback URL** field (it must begin with `https://`):

- `https://YOUR_MCP_GATEWAY_URL/integration-callback`


#### Step 4: Copy the Client ID and Client Secret

Click **Save**. Eloqua generates the **Client ID** and **Client Secret**. Copy both values.

Keep your Client Secret safe
The Client Secret is shown after creation. Treat it like a password and never expose it in client-side code or commit it to version control.

#### Step 5: Find your pod

Your **pod** is the data-center segment of your Eloqua host — for example, `p03` from `secure.p03.eloqua.com`. Sign in to Eloqua and read it from the browser URL, or call `https://login.eloqua.com/id` and use the `urls.base` value.

### Configure the Frontegg portal

Once you have your **Client ID**, **Client Secret**, and **pod**, configure the integration in the Frontegg portal:

1. Open the **Frontegg portal** and navigate to [ENVIRONMENT] → Integrations → Eloqua.
2. Enter the **Client ID** and **Client Secret**.
3. Enter your **Eloqua Pod** (for example, `p03`).
4. Select the **Full access** scope, which grants access to all Eloqua resources.
5. Click **Save**.


Keep your credentials secure
Never share or commit your Client Secret to version control.

### Additional resources

- [Register your app (Eloqua AppCloud)](https://docs.oracle.com/en/cloud/saas/marketing/eloqua-develop/Developers/AppCloud/Register/register-app-and-services.htm)
- [Authenticate using OAuth 2.0](https://docs.oracle.com/en/cloud/saas/marketing/eloqua-develop/Developers/GettingStarted/Authentication/authenticate-using-oauth.htm)
- [How to get your Redirect URL](/agen-for-work/connectors/redirect-url)