Objective
This article explains how to set up a webhook destination in Segment Journeys to trigger actions, such as sending emails or notifications, when a user enters a journey audience. The steps ensure that the webhook is correctly configured to deliver the required payload to the external service.
Product
Segment
Environment
Segment Console
User Account Permission/Role(s) Required
Workspace admin or user with permissions to edit Journeys and Destinations
Procedure
- Identify the external service’s webhook requirements, including the endpoint URL and required payload fields.
- In the Segment Console, navigate to the desired Journey.
- Add a “Send to destination” step and select the Extensible Webhook destination.
- Enter the webhook endpoint URL provided by the external service.
- Map the required fields from the user profile or event data to the payload fields expected by the external service. Use static values for fields that must always be included (such as campaign IDs).
- Ensure the user’s email or identifier is mapped to the correct field as required by the external service.
- Save the mapping configuration.
- Use the Event Tester in the Segment Console to send a test event and verify the webhook is triggered and the payload is received as expected by the external service.
- Review the response and adjust mappings if necessary.
- Publish the Journey when testing is successful.
Additional Information
Refer to the documentation of the external service for specific payload requirements. For more details on configuring webhooks in Segment, see the Segment documentation on Extensible Webhook destinations and Journeys.