Have you been looking into building an application that uses the Eloqua API?

 

If so, have you ever asked yourself:

 

I was told that Eloqua has several different APIs, which one do I use?

 

or

 

Which WSDL do I need to reference in my code to accomplish what I am trying to do?

 

Well, the table below outlines the 4 Eloqua APIs, along with their WSDL location, and general uses.

 

Eloqua API NameWSDL LocationUses
EloquaService

https://secure.eloqua.com/API/1.2/Service.svc?wsdl

This is the Standard API. It can be used to:

 

  • Perform CRUD operations on an Asset.
  • Perform CRUD operations on Entity.
  • Perform Asset Metadata operations.
  • Perform Entity Metadata operations
  • Perform Group Membership operations (Add, Remove, or List members) for Contact, Prospect, or Company Groups.
EloquaDataTransferService

https://secure.eloqua.com/API/1.2/DataTransferService.svc?wsdl

  • Updating of large numbers of records within Eloqua in a scalable fashion.
  • Bulk transfer of data from Eloqua to a streamlined file for download and manipulation (the data transfer service is the preferred method of transferring records if the number of records will regularly exceed 50000 records).
  • Export any saved report in the system that returns a list of Contact, Prospect or Company entity records.
  • Export of static reports that contain contact activity data.
  • Bulk transfer of flat files (this particular API endpoint has been optimized for transmitting binary files).

 

NOTE: The Bulk API has now replaced the DTS.  See here Eloqua Bulk API 1.0: Importing and Exporting Data for details.

 

Click Here for more details

EloquaEmailService

https://secure.eloqua.com/API/1.2/EmailService.svc?wsdl

  • Create HTML and Text email assets and related settings, such as the Subject line and the From and Reply-To display names and addresses.
  • Find existing associated email objects in the application for a given email. This includes redirect links, email field merges, email headers and footers, Activity Driven Content (ADC) rules, Signature Layouts, Email Groups, and encodings used.
  • Search for, upload, or create images or redirect links,
  • Create and schedule email batches. This allows third-party applications to use Eloqua's email engine to send email blasts to recipients. Eloqua will still enforce CAN-SPAM compliance and observe subscriber preferences, as set in the tool, even when the email send is initiated in another application. You can create an email batch (with a specified schedule and signature), send to a single recipient, or check on the status of an email batch deployment.

 

Click Here for more details

ExternalActionServicehttps://secure.eloqua.com/api/1.2/ExternalActionService.svc?wsdl

Building Cloud Connectors

 

This is just a general outline, but it should at least get you on the right track.

 

For more information, go here and read the detailed API documentation.