Journey trigger: webhook received

This guide will help you create a new journey that can be triggered by sending a POST request to a webhook URL. This allows for easy automation by integrating external systems to trigger journeys in response to specific events or actions.

Step 1: Creating a New Journey

To get started, follow these steps to create a new journey:

  1. Navigate to Journeys.
  2. Create a new Journey and choose: from scratch.
  3. When prompted to choose a trigger, select Webhook Received.
  4. After creating the journey, click the configure icon to reveal the webhook URL specific to this journey.

The webhook URL looks like this: https://api.workflows.trengo.com/capture/[..].


Step 2: Sending data to your webhook

Once the journey is created, you can send custom data to the webhook using different types of fields. This data will allow you to personalize and tailor the journey based on the values you send.

There are several types of fields you can send in your POST request:

  • Custom Ticket Fields: Data related to a specific ticket.
  • Custom Profile Fields: Attributes specific to a contact's profile.
  • Custom Contact Fields: Information related to a contact.
  • Journey Variables: Dynamic variables specific to the journey itself.
  • Contact Data: To identify the contact. Read more about the expected data structure in the API Reference.

Step 3: Sending the POST request

To trigger the journey, you will need to make a POST request to the webhook URL you received in Step 1. The request should include any custom data that you want to pass to the journey as part of its execution.

Read more here: https://developers.trengo.com/reference/invoke-a-workflow