Obtain Response Data via Webhook

Webhooks are used to obtain response data from Mandrill, such as whether your customer has subscribed or unsubscribed from your mailing. These data will be processed by CrossEngage and displayed in each campaign’s statistics. The generated data can be used to build user segments.

Your CrossEngage "Web tracking and response data API key" is needed for this Webhook configuration.

Preparing a Webhook URL

To fetch the "Web tracking and response data API key":

• Log in to your CrossEngage account.

• Navigate to Settings > System setup.

• In the API keys section, copy the “Web tracking and response data API key”.

• Paste your copied API key into the following URL instead of the placeholder "{webapikey}."

  • ​https://api.crossengage.io/mandrill/inbound/message/{webapikey}

• When finished, copy the adjusted URL.

Adding a Webhook to Mandrill

Webhook URL must be added to Mandrill to allow response data to be sent to the CrossEngage System. This is done via the following steps:

• Log in to you Mandrill account.

• Click on the small arrow icon beside the "Settings" section in the left panel menu.

• Select the Webhooks tab.

• Click the +Add a Webhook button.

• In the "Trigger on Events" section, tick all fields apart from:

  • Rejection Whitelist Changes

  • Rejection Blacklist Changes

• Paste the copied URL from the previous steps into the "Post To URL" field.

• Enter a descriptive Webhook name.

• Select Create Webhook.

Blacklist Data Webhook

• If you would like to receive blacklist data Webhook only, click the Add a Webhook button.

• In the "Trigger on Events" section, select the following fields:

  • Rejection Blacklist Changes

  • Rejection Whitelist Changes

• Paste the copied URL from previous steps into the "Post To URL" field.

• Enter a descriptive Webhook name in the "Description" field.

• Select Create Webhook.

You will now be able to view response data in your CrossEngage dashboard and use the information to build segments.