Convertr Help Centre Help Center home page
Submit a request
Sign in
  1. Convertr Help Centre
  2. Product Documentation
  3. Integration - Eloqua

Eloqua Integration Follow

Michael Konomanyi
  • August 23, 2023 16:06
  • Updated

Overview

Our Eloqua Integration allows you to connect directly to Eloqua's REST API, and create/update a contact in the Eloqua platform. We do this using the Create Contact API.

This method of integration is the most secure, but requires you to have user access into Eloqua to be able to read/write contacts.

More information on these types can be found here. This document outlines the process to set up both Types.

If you would like to post to an Eloqua form, we don't have a direct integration for this. You can however use HTTP Integration Example: Eloqua Forms.

 

Prerequisites

Depending on the Authentication Type you will be using, you will need two different sets of information.

Basic Authentication - You will need the following:

1. Username

2. Password

3. Site (Company Name on Eloqua login page)

4. REST API Fields - (for core data fields you need the names. For custom fields, you need the IDs)

5. API URL

 

OAuth2.0 - You will need the following:

1. Eloqua Connected App created for OAuth flow

2. Eloqua Connected App Client ID

3. Eloqua Connected App Client Secret

4. Username (one time use)

5. Password (one time use)

6. Site (Company Name on Eloqua login page) (one time use)

7. API URL

 

For both configurations, your Eloqua user account must have permissions to Manage Contacts.

 

Setup

1. Navigate to your chosen campaign, and go to Processr > Integration. Click Add Job, then select Integrate with Eloqua.

save image

 

2. The configuration window will now open.

a) Configuring the Basic Authentication Type

As standard the Basic Authentication is pre-selected. To continue with the Basic Authentication method simple leave the field 'authentication_type' as 'basic' and fill out the rest of the fields using your prerequisites.

Screenshot_2020-09-01_at_12.40.12.png

 

b) Configuring the OAuth Authentication Type

To complete the setup of the OAuth Authentication Type, there are a few more steps to complete.

Next to the field 'authentication_type' select the field and remove the word 'basic' and a dropdown will appear. From the dropdown select 'oauth'

Screenshot_2020-09-01_at_12.40.18.png

Once selected, click out of the fields to allow the settings to update.

Note: you will notice that the field 'site' is removed and the button 'Get Eloqua Token' button appears

Screenshot_2020-09-01_at_12.50.44.png

 

Enter the rest of your client details from your prerequisites. You will also notice that as you add the Eloqua details the 'Get Eloqua Token' button will become available. This button will generate the Eloqua OAuth Token.

get_token.png

 

After selecting 'Get Eloqua Token' you will be taken through to the Eloqua instance. Here you will need to login with the details provided to you by the client to confirm the connection.

Screen_Shot_2020-09-02_at_18.07.00.png

Once you have logged in you will get a message asking you to confirm the connection. Select Accept.

Screen_Shot_2020-09-02_at_18.08.33.png

Finally, you will be shown the Eloqua OAUTH Token screen which confirms that the connection is successful.

Screen_Shot_2020-09-02_at_18.08.57.png

 

5. The next step is to enter the clients' field names. The core data field names are entered into the mapping section, as below.

Please note: The clients' field names should be entered on the left and the matching Convertr field names are entered on the right.

save image

You can find the names of the core data fields on the Eloqua documentation, and select the ones you need.

6. If you also wish to map to custom fields, in the customValues section you will need to fill in each item as follows:

  • id: the ID of the field you wish to map in Eloqua; this can be found within the Eloqua instance.
  • field: this is the field name within Convertr to map to.

save image

 

7. Once you have completed the mapping, the integration is complete and ready to test. It will look like the below:

save image

Articles in this section

  • Introduction To Eloqua And How To Create Your Custom Application In Eloqua
  • Eloqua Integration
  • The Integrate to Eloqua Job
  • The Create/Update Eloqua Integration Job
  • Eloqua Custom Objects and Fields
  • Integrating to Eloqua Custom Fields

Related articles

  • HTTP Integration Example: Eloqua Forms
  • Introduction To Eloqua And How To Create Your Custom Application In Eloqua
  • Integrating with Hubspot
  • Integrating with Salesforce
  • Deliver Leads to an External Form URL Using the HTTP Post Integration
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request
Return to top

Related articles

  • HTTP Integration Example: Eloqua Forms
  • Introduction To Eloqua And How To Create Your Custom Application In Eloqua
  • Integrating with Hubspot
  • Integrating with Salesforce
  • Deliver Leads to an External Form URL Using the HTTP Post Integration