Actions15
Overview
This node integrates with the Oracle Eloqua REST API to manage contacts. Specifically, the 'Create' operation under the 'Contact' resource allows users to add new contact entries to their Eloqua database. It supports setting a mandatory email address along with various optional fields such as name, status, phone numbers, addresses, and subscription details. Additionally, users can set custom contact fields by specifying field IDs and their values. This node is useful for marketing automation workflows where new contact data needs to be programmatically added to Eloqua, for example, when capturing leads from a web form or syncing contacts from another CRM system.
Use Case Examples
- Creating a new contact with just an email address.
- Creating a contact with detailed information like first name, last name, phone numbers, and subscription status.
- Adding custom field values to a contact during creation.
Properties
| Name | Meaning |
|---|---|
| Authentication | The authentication method to use for connecting to Eloqua API (Basic Authentication or OAuth2). |
| Email Address | The email address of the contact. This is a required field for creating a contact. |
| Additional Fields | Optional additional fields for the contact such as current status, name, description, first name, last name, email format preference, subscription status, addresses, phone numbers, and more. |
| Custom Contact Fields | Custom fields to set specific values by field ID and value pairs, allowing for extended contact data customization. |
Output
JSON
id- The unique identifier of the created contact.emailAddress- The email address of the created contact.fieldValues- An array of custom field values set on the contact.additionalFields- Other optional fields set on the contact such as name, status, phone numbers, addresses, etc.
Dependencies
- Oracle Eloqua REST API
Troubleshooting
- Ensure the email address is provided and valid, as it is required for creating a contact.
- Authentication errors may occur if the provided credentials (Basic Auth or OAuth2) are incorrect or expired.
- API rate limits or permissions might restrict creating contacts; verify API access rights in Eloqua.
- Custom field IDs must be valid and exist in Eloqua; otherwise, the API may reject the request.
Links
- Oracle Eloqua REST API Documentation - Official documentation for Oracle Eloqua REST API endpoints and usage.