Creating or editing an endpoint for Eloqua ReST API activity
Endpoints provide the configuration information that the Studio and the Integration Appliance use to connect to Eloqua platform. Eloqua ReST API uses OAuth 2.0 authentication mechanism so as to authorize users to perform operations.
Selecting or editing an Eloqua ReST API endpoint
To select or edit an Eloqua ReST API endpoint:
- In the Create Endpoint or Edit Endpoint pane,
configure the Eloqua ReST API endpoint as described in the following table.Note: Changing the configuration properties of an endpoint affects all orchestrations that use that endpoint in the project. The edits are global, not local.
- Click Test Connection to confirm that the connection details are valid and you are able to connect to the Eloqua ReST API successfully.
- Click OK.
Field Name | Description |
---|---|
Login URL | Login URL to connect with Eloqua endpoint. |
OAuth Access Token | OAuth access token generated from Eloqua ReST API for authentication. |
OAuth Refresh Token | OAuth refresh token generated from Eloqua ReST API while generating OAuth Access token. |
Application Client ID | The Client Identifier issued to the application during registration. |
Application Client Secret | The Client Secret issued to the application during registration. |
Application Redirect URL | The Redirect URL issued to the application during registration. |
Note:
- To generate the access token, refer to the Oracle Eloqua ReST API documentation relating to "OAuth2 Authentication Support in Eloqua ReST API".
- The Login URL has default value as https://login.eloqua.com/id. It is editable and the URL format is – https://<host>:<port>/id - You can change the host, port and protocol (http/https) as needed if not using the default.
- In the Map Input section of each activity, relevant fields of endpoint panel are available to override at runtime. You can provide data to various groups of parameters like Proxy Details, Connection Details or Authentication Details to override. Providing only partial field data in a selected group is not allowed to override.
Objects Supported by the Eloqua ReST API Connector
Eloqua ReST API connector supports the following Eloqua objects:
Eloqua Objects | Create | Retrieve | Update | Delete |
---|---|---|---|---|
Accounts | Yes | Yes | Yes | Yes |
Campaigns | Yes | Yes | Yes | Yes |
Contacts | Yes | Yes | Yes | Yes |
Contact Lists | Yes | Yes | Yes | Yes |
Contact Segments | Yes | Yes | Yes | Yes |
Custom Object Data | Yes | Yes |
Custom Objects/Custom Fields Support
Eloqua supports most of the special characters in the Name for the Custom Objects or its Fields.
However, since the connector uses XML based input/output, only those Custom Objects would be
supported whose names/fields contain following specific special characters:
- . (Dot)
- - (Hyphen)
- _ (Underscore)
- Space – in case of space it will be replaced by double underscore.
Note:
- Eloqua ReST API Connector supports Custom objects/fields if names begin with a letter (alphabet) and can be followed by alphanumeric characters or followed by specific special characters Dot (.), Hyphen(-),Underscore( _ ), and Space ( ). Custom Objects having any other special characters in name/fields would be skipped in the Connector.
- Eloqua ReST API Connector does not support Custom objects if their object/field names contains two consecutive underscore.