Versions Compared

Old Version 13

changes.mady.by.user Chandna Mitra

Saved on

compared with

New Version 14

changes.mady.by.user Mohammed Iqbal

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

On this Page

Table of Contents
maxLevel2
excludeOlder Versions|Additional Resources|Related Links|Related Information

Snap type:

Write


Description:

This Snap invokes an Eloqua REST API Create endpoint to create 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. Check the Eloqua API documentation to understand the 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 created. This document is produced by the Eloqua endpoint. It describes the new object in its entirety and includes the new object's ID, which can be used for further operations on the object.
Prerequisites:

[None]

Support and limitations:Works in Ultra Pipelines.
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 create. 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 Data
  • 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 Activities 2.0
  • External Assets 2.0
  • External Asset Types 2.0
  • Forms
  • Forms 2.0
  • Form Submission Data
  • Images 2.0
  • Imported Files 2.0
  • Landing Pages
  • Landing Pages 2.0
  • Microsites
  • Microsites 2.0
  • Option Lists
  • Option Lists 2.0
Note
All types without a specified version number are version 1.0.

Example: Contacts
Default value: Accounts

Multiexcerpt include macro
nameSnap Execution
pageSOAP Execute

Multiexcerpt include macro
nameExecution_Detail_Write
pageSOAP Execute

Example

Sample Input Document

Code Block
{
  "emailAddress": "s.smith@Snaplogic.com",
  "firstName": "Somebody",
  "lastName": "Smith",
  "title": "Sr. Software Engineer",
  "accountName": "SnapLogic",
  "businessPhone": "123-456-7890",
  "mobilePhone": "987-654-3210",
  "address1": "929 Pearl St",
  "address2": "Suite 200",
  "city": "Boulder",
  "province": "CO",
  "postalCode": "80302",
  "country": "USA",
  "fieldValues": [
    {
      "id": "100017",
      "value": "Sir"
    },
    {
      "id": "100043",
      "value": "Developer"
    }
  ]
}


Sample Output Document


Code Block
{
  "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": "Sir"
    },
    ...
    {
      "type": "FieldValue",
      "id": "100043",
      "value": "Developer"
    }
    ...
  ],
  "firstName": "Somebody",
  "isBounceback": "false",
  "isSubscribed": "true",
  "lastName": "Smith",
  "mobilePhone": "987-654-3210",
  "postalCode": "80302",
  "province": "CO",
  "subscriptionDate": "1450313715",
  "title": "Sr. Software Engineer"
}

Sample Error Document


Code Block
{
  "reason": "Conflicts Found",
  "details": [
    {
      "type": "ObjectValidationError",
      "container": {
        "type": "ObjectKey",
        "objectType": "Contact"
      },
      "property": "emailAddress",
      "requirement": {
        "type": "UniquenessRequirement",
        "uniquenessScope": "global"
      },
      "value": "s.smith@Snaplogic.com"
    }
  ],
  "status_code": 409,
  "original": {
    "emailAddress": "s.smith@Snaplogic.com",
    "firstName": "Somebody",
    ...
  },
  "error": "The POST request failed",
  "url": "https://secure.p02.eloqua.com/API/REST/2.0/data/contact"
}

Insert excerpt
Eloqua Snap Pack
Eloqua Snap Pack
nopaneltrue