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 Name | WSDL Location | Uses |
|---|
| 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 |
| ExternalActionService | https://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.