Configuring webhook connections

The Webhook app creates an outbound integration between Oracle Eloqua and configured 3rd party platforms and systems. A webhook is a way for an app to provide other applications with near real-time information. It delivers data to other applications as it happens, making webhooks much more efficient for the provider and consumer. The webhook will make an HTTP request to an app (typically an HTTP POST request), and it is the responsibility of the webhook provider to interpret it.

Good to know

  • Webhook Name and Webhook URL are the only two mandatory attributes.
  • HTTPS connection is required.
  • Authorization settings are optional.
  • You can configure the JSON payload or query parameters to include static data and dynamic Eloqua contact and custom object record values.
  • If you use Eloqua custom objects, please ensure you select the related custom object program.
  • Before enabling and using it in Eloqua programs, you must test the webhook configuration. If you make any changes to the existing webhook configuration, you are required to test it again.

Note: While adding Oracle Eloqua contact or custom object placeholders to query parameters or JSON payload, type the "@" sign to see the list of available attributes.

To configure a webhook connection:

  1. Navigate to SettingsAn image of the Settings menu icon, which is represented by a black cog. > Apps, and open the Webhook app.
  2. In the Webhook app, click Create Webhook.
  3. Complete the Configuration details:
    • Webhook Name: a unique and meaningful name is recommended
    • Webhook Description: any notes that explain the purpose of the webhook
    • Request Type: POST
    • Webhook Type: Outbound
    • Webhook URL: a URL that will be called from the Eloqua Program or Campaign
    • Eloqua Object: contact or any available Eloqua custom object
    • Enable Query Parameters: use this option if you need to send Eloqua data as key-value pairs attached to the end of a URL

  4. Complete the Headers. 

    Add any required HTTP headers. Please note that the "Content-Type: application/json" is added automatically if a JSON payload is configured

  5. Complete theAuthorization:
    • None (default)
    • Basic Auth: Basic authentication involves sending a verified username and password with your request
    • Bearer Token: Bearer tokens enable requests to authenticate using an access key. The token is a text string, included in the request header
    • API Key: With API key authentication, you send a key-value pair to the API in the request header
    • Body Optionally, you can specify the JSON payload included with your request.

  6. Complete the Test Configuration:

    Select one of the available Eloqua contact or custom object records that will be used to test your configuration. Please note that a 2xx response must be received before you can use the webhook in Eloqua campaigns or programs. Once you select the test record, save your configuration and navigate to the main screen. Learn more about testing connections.

     

     

After you finish: After you configured and tested the webhook, you can use it in a program or campaign. Learn more.

Learn more

Testing webhook connections

Using the app in a program or campaign

Webhook app FAQ