Eloqua Read

Overview

The Eloqua Read Snap reads an Eloqua object of a specified type by ID using the Eloqua REST API Read endpoint. Use this Snap to retrieve contacts, accounts, custom objects, and other Eloqua entities by their unique identifiers.

Snap views

Type Description Examples of upstream and downstream Snaps
Input A document containing the ID or search criteria for the Eloqua object to read. Optional input view for passing parameters.
Output A document containing the Eloqua object data retrieved from the API.
Learn more about Error handling.

Snap settings

Legend:
  • Expression icon (): Allows using JavaScript syntax to access SnapLogic Expressions to set field values dynamically (if enabled). If disabled, you can provide a static value. Learn more.
  • SnapGPT (): Generates SnapLogic Expressions based on natural language using SnapGPT. Learn more.
  • Suggestion icon (): Populates a list of values dynamically based on your Snap configuration. You can select only one attribute at a time using the icon. Type into the field if it supports a comma-separated list of values.
  • Upload : Uploads files. Learn more.
Learn more about the icons in the Snap settings dialog.
Field/Field set Type Description
Label

String

Required. Specify a unique name for the Snap. Modify this to be more appropriate, especially if more than one of the same Snaps is in the pipeline.

Default value: Eloqua Read

Example: Contact leads
Core object type

Dropdown list

Required. The type of core object involved in the query. Options include Accounts, Contacts, Campaigns, Custom Objects, Emails, Forms, Landing Pages, Visitors, and more (version 1.0 and 2.0).

Default value: Accounts

Example: Contacts
Depth

Dropdown list
The depth or level of detail returned:
  • minimal (basic properties)
  • partial (all properties with related entities at minimal depth)
  • complete (all properties with related entities at complete depth)

Default value: minimal

Example: partial
Page Size

Integer

Maximum number of entities to fetch from a single call to the Eloqua endpoint. Consider using a smaller value when a single page is likely to contain a large amount of data. The Snap automatically fetches multiple pages and combines the results.

Default value: 1000

Example: partial
Count

Integer

Maximum number of total entities to return. If not specified, all entities will be returned.

Default value: None

Example: partial
Search

String/Expression

Specifies the search criteria used to retrieve entities. Format: [{term} {operator}] {value}. If term and operator are not supplied, the 'name' field is compared using the equality operator.

Default value: None
Additional parameters

String

A table that contains name-value pairs for custom parameters.

Default value: None

Example: partial
Pass through

Checkbox

Select this checkbox to enable the Snap to pass the input document to the output view under the key original.

Default value: Deselected
Snap execution

Dropdown list

 Choose one of the three modes in which the Snap executes.
Available options are:
  • Validate & Execute. Performs limited execution of the Snap and generates a data preview during pipeline validation. Subsequently, performs full execution of the Snap (unlimited records) during pipeline runtime.
  • Execute only. Performs full execution of the Snap during pipeline execution without generating preview data.
  • Disabled. Disables the Snap and all Snaps that are downstream from it.

Default value: Execute only

Example: Validate & Execute