Eloqua Update

Eloqua Update

On this Page

Snap type:

Write


Description:

This Snap invokes an Eloqua REST API Update endpoint to modify an Eloqua object of a specified type.

  • Expected input: The Snap invokes the Eloqua endpoint for the given object type once for each input document, using the document as the content sent to the endpoint. This document must include a field called "id" which identifies an Eloqua object of the specified object type. Any fields not specified in the document will not be modified in the object. Check the Eloqua API documentation to understand the other required and supported fields specific to the object type. Note that the Eloqua documentation is not very complete/accurate in this respect. 
  • Expected output: The Snap outputs exactly one document for each object successfully updated. This document is produced by the Eloqua endpoint. It describes the updated object in its entirety, including both modified and unmodified fields.


Prerequisites:

[None]


Support and limitations:

Works in Ultra Tasks.

Account: 

This Snap uses account references created on the Accounts page of SnapLogic Manager to handle access to this endpoint. See Eloqua Account for more information.

Views:
InputThis Snap has exactly one document input view. The Eloqua endpoint is invoked once for each input document.
OutputThis Snap has exactly one document output view and produces one document in the view for each successful call to the Eloqua endpoint.
ErrorThis Snap has at most one document error view and produces zero or more documents in the view.

Settings

Label


Required. The name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your pipeline.

Core object type


Required. The type of core object to update. The options available include:
  • Accounts
  • Accounts 2.0
  • Account Fields
  • Account Fields 2.0
  • Campaigns
  • Campaigns 2.0
  • Contacts
  • Contacts 2.0
  • Contact Fields
  • Contact Fields 2.0
  • Contact Lists
  • Contact Lists 2.0
  • Contact Segments
  • Contact Segments 2.0
  • Content Sections
  • Content Sections 2.0
  • Custom Object Metadata
  • Custom Object Metadata 2.0
  • Emails
  • Emails 2.0
  • Email Folders
  • Email Folders 2.0
  • Email Footers
  • Email Footers 2.0
  • Email Groups
  • Email Groups 2.0
  • Email Headers
  • Email Headers 2.0
  • External Assets 2.0
  • External Asset Types 2.0
  • Forms
  • Forms 2.0
  • Images 2.0
  • Imported Files 2.0
  • Landing Pages
  • Landing Pages 2.0
  • Microsites
  • Microsites 2.0
  • Option Lists
  • Option Lists 2.0
  • System Users
  • System Users 2.0


All types without a specified version number are version 1.0.

Example: Contacts
Default value: Accounts


Pass through

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

Default value: Deselected

Loading

Loading

Examples


Sample Input Document


{
  "id": "49",
  "emailAddress": "s.smith@Snaplogic.com",
  "salesPerson": "Bob B",
  "fieldValues": [
    {
      "id": "100017",
      "value": "Mr."
    }
  ]
}


Sample Output Document


{
  "type": "Contact",
  "currentStatus": "Awaiting action",
  "id": "49",
  "createdAt": "1450313715",
  "depth": "complete",
  "name": "s.smith@Snaplogic.com",
  "updatedAt": "1450313715",
  "accountName": "SnapLogic",
  "address1": "929 Pearl St",
  "address2": "Suite 200",
  "businessPhone": "123-456-7890",
  "city": "Boulder",
  "country": "USA",
  "emailAddress": "s.smith@Snaplogic.com",
  "emailFormatPreference": "unspecified",
  "fieldValues": [
    {
      "type": "FieldValue",
      "id": "100005"
    },
    {
      "type": "FieldValue",
      "id": "100017",
      "value": "Mr."
    },
    ...
    {
      "type": "FieldValue",
      "id": "100043",
      "value": "Developer"
    }
    ...
  ],
  "firstName": "Somebody",
  "isBounceback": "false",
  "isSubscribed": "true",
  "lastName": "Smith",
  "mobilePhone": "987-654-3210",
  "postalCode": "80302",
  "province": "CO",
  "salesPerson": "Bob B",
  "subscriptionDate": "1450313715",
  "title": "Sr. Software Engineer"
}

Sample Error Document


{
  "reason": "Object Not Found (id: 49)",
  "status_code": 404,
  "original": {
    "id": "49",
    ...
  },
  "error": "The PUT request failed",
  "url": "https://secure.p02.eloqua.com/API/REST/2.0/data/contact/49"
}

Snap Pack History


 Click to view/expand

Release 

Snap Pack Version

Date

Type

  Updates

November 2025

main33142

Stable

Updated and certified against the current SnapLogic Platform release.

August 2025

main32088

Stable

Updated and certified against the current SnapLogic Platform release.

May 2025

main31019

 

Stable

Updated and certified against the current SnapLogic Platform release.

February 2025

main29887

 

Stable

Updated and certified against the current SnapLogic Platform release.

November 2024

main29029

 

Stable

Updated and certified against the current SnapLogic Platform release.

August 2024

main27765

 

Stable

Updated and certified against the current SnapLogic Platform release.

May 2024

main26341

 

Stable

Updated and certified against the current SnapLogic Platform release.

February 2024

main25112

 

Stable

Updated and certified against the current SnapLogic Platform release.

November 2023

main23721

 

Stable

Updated and certified against the current SnapLogic Platform release.

August 2023

main22460

 

Stable

Updated and certified against the current SnapLogic Platform release.

May 2023

main21015

 

Stable

Upgraded with the latest SnapLogic Platform release.

February 2023

main19844

 

Stable

Upgraded with the latest SnapLogic Platform release.

November 2022

main18944

 

Stable

The Eloqua Snaps now include the Pass through checkbox, which enables the Snap to pass the input document to the output view under the key original.

August 2022

430patches17270

 

Latest

The Custom Object Metadata ID field in the Eloqua Create Snap allows you to specify an ID for creating custom object data. This conditional field appears only when you select Custom Object Data as the Core object type.

August 2022

main17386

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.29

main15993

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.28

main14627

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.27

main12833

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.26

main11181

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.25

main9554

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.24

main8556

Stable

Upgraded with the latest SnapLogic Platform release.

4.23

main7430

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.22

main6403

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.21

snapsmrc542

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.20

snapsmrc535

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.19

snaprsmrc528

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.18

snapsmrc523

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.17

ALL7402

 

Latest

Pushed automatic rebuild of the latest version of each Snap Pack to SnapLogic UAT and Elastic servers.

4.17

snapsmrc515

 

Latest

Added the Snap Execution field to all Standard-mode Snaps. In some Snaps, this field replaces the existing Execute during preview check box.

4.16

snapsmrc508

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.15

snapsmrc500

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.14

snapsmrc490

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.13

snapsmrc486

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.12

snapsmrc480

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.11

snapsmrc465

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.10

snapsmrc414

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.9

snapsmrc405

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.8

snapsmrc398

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.7

snapsmrc382

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.6

snapsmrc362

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.5.1

snapsmrc344

 

Latest

Upgraded with the latest SnapLogic Platform release.

4.5

snapsmrc344

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.4.1

N/A

 

Latest

Upgraded with the latest SnapLogic Platform release.

4.4

N/A

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.3.2

N/A

 

Latest

  • NEW! Create, Delete, Query Activities, and Update Snaps added.

  • Added core object types to support all remaining REST 1.0 and 2.0 endpoints in Read and Query Snaps.

  • Read Snap now supports expressions for Search setting and an input view.

  • Resolved an issue with Eloqua Snaps not correctly obtaining the base URL from the login id endpoint.

  • Resolved an issue with Eloqua Snaps not handling Additional Parameters correctly.

  • Resolved an issue with Eloqua Read settings listing core object types that aren't applicable for this Snap and will always fail.

  • Resolved an issue with Eloqua Read and Query Snap not able read or query External Asset object type.

  • Resolved an exception with Eloqua Query when Activities returns no content.

  • Resolved an exception with Eloqua Query when Activities returns content.

  • Resolved an issue with Eloqua Read returning duplicate items when Count was greater than 1000.