Requires administrator rights or the following permission:

Journeys


Journeys can be triggered by external events using Adversus' built-in webhook endpoint. This is how it's configured.


  1. Go to Journeys in the menu on the left.

  2. Under Available integrations, choose Webhook and Connect Webhook with Adversus.

  3. Give the Webhook a proper name for easy recognition afterward.

  4. This example is focused on updating existing leads, but it can also be used to create or update contacts. The trigger type is defined by the Resource type, which is being set to Leads.


Testing your endpoint

To ensure your endpoint is live and see how your data is being processed in Adversus, you can test the endpoint by cURL'ing the trigger URL.

NB: Remember to replace <YOUR TRIGGER URL HERE> and <YOUR TOKEN HERE>.

curl --location --request POST '<YOUR TRIGGER URL HERE>' \--header 'Authorization: Bearer <YOUR TOKEN HERE>' \--header 'Content-Type: application/json' \--data-raw '{"leadId": 292784703,"updatedName": "John Doe","updatedPhone": "+45 86 3000 86"}'

After you have requested with cURL, you can see a preview of the data.

Since we are updating an existing resource (in this case, a lead) we have to match a property from the request to a reference in Adversus.


This can be done using either a custom field (phone number, external ID, etc.) or by using the lead ID if that is known. In this case, we will match on ID, since this is included in our webhook request.

Now, map the fields you want to use in the journey builder under Webhook fields.

You're all set up! Click submit in the bottom and you're ready to create a Journey using your Webhook trigger.👌


Did this answer your question?