Page Comparison

...

Table of Contents
maxLevel 3 type flat

...

Overview

The following operations allow you to work with Contact Lists. Click an operation name to see details on how to use it.

For a sample proxy service that illustrates how to work with Contact Lists, see Sample configuration .

For more details click Contact Lists.

Operation Details

This section provides further details on the operations related to Contact Lists.

Anchor
createAContactList createAContactList

Create A Contact List

The createAContactList operation creates a new contact list.

<eloqua<eloquaStandardAPI.createAContactList>
    <scope>global</scope>
    <count>10</count>
    <membershipAdditions>["1"]</membershipAdditions>
    <name>my new contact list</name>
    <dataLookupId>3965b95a-9e64-42bf-9d8d-a277bf02184f</dataLookupId>
    <membershipDeletions>["1"]</membershipDeletions>
</eloquaeloquaStandardAPI.createAContactList>

properties

• scope               : To create a contact list on this scope.

• count               : The number of the contacts on a list.
• membershipAdditions : Boolean value, to set the permission to add members.
• name                : Name of the contact list to create the list on this name.
• dataLookupId        : The identifier of data lookup.
• membershipDeletions : Boolean value, to set the permission to delete members.

Sample request

Following is a sample REST/JSON request that can be handled by the createAContactList operation.

{
   "username":"myusername",
   "password":"mypassword",
   "siteName":"mysiteName",
   "scope":"global",
   "count":10,
   "membershipAdditions":["1"],
   "name":"my new contact list",
   "dataLookupId":"3965b95a-9e64-42bf-9d8d-a277bf02184f",
   "membershipDeletions":["1"]
}

Anchor
updateAContactList updateAContactList

Update A Contact List

The updateAContactList operation updates a contact list.

<eloqua<eloquaStandardAPI.updateAContactList>
    <scope>global</scope>
    <count>10</count>
    <membershipAdditions>["1"]</membershipAdditions>
    <name>my new contact list</name>
    <dataLookupId>3965b95a-9e64-42bf-9d8d-a277bf02184f</dataLookupId>
    <membershipDeletions>["1"]</membershipDeletions>
</eloquaeloquaStandardAPI.updateAContactList>

properties

• contactListId       : Unique identifier of the contact list.

• scope               : To create a contact list on this scope.

• count               : The number of the contacts on a list.
• membershipAdditions : Boolean value, to set the permission to add members.
• name                : Name of the contact list to update the list on this name.
• dataLookupId        : The identifier of data lookup.
• membershipDeletions : Boolean value, to set the permission to delete members.

Sample request

Following is a sample REST/JSON request that can be handled by the updateAContactList operation.

{   
   "username":"myusername",
   "password":"mypassword",
   "siteName":"mysiteName",
   "contactListId":"1",
   "scope":"global",
   "count":10,
   "membershipAdditions":["1"],
   "name":"my new contact list",
   "dataLookupId":"3965b95a-9e64-42bf-9d8d-a277bf02184f",
   "membershipDeletions":["1"]
}

Anchor
getAllContactLists getAllContactLists

Get All Contact Lists

The getAllContactLists operation retrieves all contact lists.

<eloqua<eloquaStandardAPI.getAllContactLists>
    <count>2</count>
    <depth>1</depth>
    <search></search>
    <page>1</page>
    <orderBy></orderBy>
    <lastUpdatedAt>1426066807</lastUpdatedAt>
    <extensions>1</extensions>
</eloquaeloquaStandardAPI.getAllContactLists>

properties

• count         : The number of results in a page to display. This must me in between 1 and 1000.

• depth         : The RequestDepth. It can be 'Complete' or 'Reference' or 'Minimal' or 'Partial'.

• search        : The search field, to search for that field.

• page          : The page number to display. This must be greater than 1.

• orderBy       : The order by property to order the fields.

• lastUpdatedAt : The date time of the last update.

• extensions    : The identifier of the view.

Anchor
sampleRequest sampleRequest

Sample Request

Following is a sample REST/JSON request that can be handled by getAllContactLists operation.

{   
   "username":"myusername",
   "password":"mypassword",
   "siteName":"mysiteName",
   "count":2,
   "page":1,
   "lastUpdatedAt":1426066807,
   "depth":"Complete",
   "extensions":"1"
}

Anchor
getAContactList getAContactList

Get A Contact List

The getAContactList operation retrieves the details of a contact list associated with the specified contact list id.

<eloqua<eloquaStandardAPI.getAContactList>
	<contactListId>1</contactListId>
	<depth>Complete</depth>
	<extensions></extensions>
</eloquaeloquaStandardAPI.getAContactList>

properties

• contactListId : Unique identifier of the contact list.

• depth         : The RequestDepth. It can be 'Complete' or 'Reference' or 'Minimal' or 'Partial'.

• extensions    : The identifier of the view.

Sample request

Following is a sample REST/JSON request that can be handled by the getAContactList operation.

{   
   "username":"myusername",
   "password":"mypassword",
   "siteName":"mysiteName",
   "contactListId":"1",
   "depth":"Complete"
}

Anchor
updateAContactList updateAContactList

Delete A Contact List

The deleteAContactList operation deletes a contact list information associated with the specified contact list id.

<eloqua<eloquaStandardAPI.deleteAContactList>
	<contactListId>1</contactListId>
</eloquaeloquaStandardAPI.deleteAContactList>

properties

• contactListId : Unique identifier of the contact list.

Sample request

Following is a sample REST/JSON request that can be handled by the deleteAContactList operation.

{  
   "username":"myusername",
   "password":"mypassword",
   "siteName":"mysiteName",
   "contactListId":"1"
}

Anchor
sampleProxy sampleProxy

Sample Configuration

Following is a sample proxy service that illustrates how to connect to Eloqua Standard API with the init operation to use the getAllContactLists operation. The sample request for this proxy can be found in getAllContactLists sample request . You can use this sample as a template for using other operations in this category.

<proxy xmlns="http://ws.apache.org/ns/synapse"
       name="eloqua_getAllContactLists"
       transports="https,http"
       statistics="disable"
       trace="disable"
       startOnLoad="true">
    <target>
        <inSequence>
            <property name="siteName" expression="json-eval($.siteName)"/>
            <property name="username" expression="json-eval($.username)"/>
            <property name="password" expression="json-eval($.password)"/>
            <property name="count" expression="json-eval($.count)"/>
            <property name="depth" expression="json-eval($.depth)"/>
            <property name="search" expression="json-eval($.search)"/>
            <property name="page" expression="json-eval($.page)"/>
            <property name="orderBy" expression="json-eval($.orderBy)"/>
            <property name="lastUpdatedAt" expression="json-eval($.lastUpdatedAt)"/>
            <property name="extensions" expression="json-eval($.extensions)"/>
            <eloqua<eloquaStandardAPI.init>
                <siteName>{$ctx:siteName}</siteName>
                <username>{$ctx:username}</username>
                <password>{$ctx:password}</password>
            </eloquaeloquaStandardAPI.init>
            <eloqua<eloquaStandardAPI.getAllContactLists>
                <count>{$ctx:count}</count>
                <depth>{$ctx:depth}</depth>
                <search>{$ctx:search}</search>
                <page>{$ctx:page}</page>
                <orderBy>{$ctx:orderBy}</orderBy>
                <lastUpdatedAt>{$ctx:lastUpdatedAt}</lastUpdatedAt>
                <extensions>{$ctx:extensions}</extensions>
            </eloquaeloquaStandardAPI.getAllContactLists>
            <respond/>
        </inSequence>
        <outSequence/>
        <faultSequence/>
    </target>
    <description/>
</proxy>