Webhooks (Actions) Destination

Destination Info

Additional versions of this destination are available

This page is about the Webhooks (Actions) Destination. See below for information about other versions of the Webhooks destination:

Segment’s Webhooks (Actions) destination uses internet protocol and HTTP callback to submit real-time user data to your own HTTP endpoints. With this destination, you can POST, PUT, or PATCH data to any webhook URL.

Getting Started

  1. From the Segment web app, navigate to Connections > Catalog.
  2. Search for Webhooks (Actions) in the Destinations Catalog, and select the destination.
  3. Click Configure Webhooks (Actions).
  4. Select the source that will send data to Webhooks (Actions) and follow the steps to name your destination.
  5. If you require authentication, add in a shared secret on the Settings > Advanced Settings tab. If you provide a shared secret, Segment will sign requests with an HMAC in the “X-Signature” request header. The HMAC is a hex-encoded SHA1 hash generated using the shared secret and the request body.
  6. Follow the steps in the Destinations Actions documentation on Customizing mappings. You can create up to 5 mappings, each of which can send to a different webhook URL.
  7. Enable the destination and configured mappings.

Destination Settings

Setting Description
Shared Secret

If set, Segment will sign requests with an HMAC in the “X-Signature” request header. The HMAC is a hex-encoded SHA1 hash generated using this shared secret and the request body.

Available Actions

Build your own Mappings. Combine supported triggers with the following Webhooks-supported actions:

Mapping limits per destination

Individual destination instances have support a maximum of 50 mappings.


Send an HTTP request.

Send is a Cloud action.

Click to show / hide fields

Field Description

URL to deliver data to.

Method* Type: STRING

HTTP method to use.

Batch Size Type: NUMBER

Maximum number of events to include in each batch. Actual batch sizes may be lower.

Headers Type: OBJECT

HTTP headers to send with each request.

Data Type: OBJECT

Payload to deliver to webhook URL (JSON-encoded).

Enable Batching? Type: BOOLEAN

When enabled, Segment will send events in batches.

Batch size limits

In Webhook Actions mapping, the default value of batch size is 1000. You can change this value, but there’s a maximum batch size limit of 4000.

This page was last modified: 14 Aug 2023

Get started with Segment

Segment is the easiest way to integrate your websites & mobile apps data to over 300 analytics and growth tools.
Create free account