# Send Events to HTTP Webhook Destination


This guide demonstrates how RudderStack transforms the event payload according to the specified destination configuration settings before sending it to the HTTP webhook endpoint.

## Overview

{{< info >}}
This integration supports sending data only in [cloud mode]({{< ref "destinations/rudderstack-connection-modes.md#cloud-mode" >}}).
{{< /info >}}

RudderStack does not place any constraints on the event format for the requests sent to your configured HTTP webhook endpoint. It transforms the event payload based on your [event configuration settings]({{< ref "destinations/http-webhook/setup-guide.md#event-configuration-settings" >}}) before sending it to the specified webhook endpoint.

## Example

This end-to-end example highlights the structure of the sample payload sent to your webhook endpoint.

### Configuration settings

This section highlights the HTTP webhook configuration settings specified in the RudderStack dashboard, specifically the [Base URL]({{< ref "destinations/http-webhook/setup-guide.md#connection-settings" >}}), [body format]({{< ref "destinations/http-webhook/setup-guide.md#connection-settings" >}}), and the [event configuration settings]({{< ref "destinations/http-webhook/setup-guide.md#event-configuration-settings" >}}).

#### [**Base URL**]({{< ref "destinations/http-webhook/setup-guide.md#connection-settings" >}})

`https://example.com`

####  [**Request URL settings**]({{< ref "destinations/http-webhook/setup-guide.md#request-url" >}})

- **Path parameters (in sequence)**: 

| Path parameter |
| :---| 
| `path` |
| `$.userId` |

- **Query parameters**: 

| Key | Value |
| :----| :---|
| `key` | `value` |

####  [**Headers settings**]({{< ref "destinations/http-webhook/setup-guide.md#headers" >}})

| Key | Value |
| :----| :---|
| `header` | `header_value` |

####  [**Request body settings**]({{< ref "destinations/http-webhook/setup-guide.md#request-body" >}})

- XML Root Key (only applicable for XML body format): `root`
- Field mappings:

| Key | Value |
| :----| :---|
| `$.event` | `$.event` |
| `$.currency` | `$.properties.currency` |
| `$.userId` | `$.userId` |

### Event request

The `track` event request sent from the source connected to this HTTP webhook destination is shown below:

{{< tabs tabTotal="2" >}}
{{% tab tabName="CURL" %}}
```bash
curl --location '<DATA_PLANE_URL>/v1/track' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic <token>' \
--data '{
  "userId": "user123",
  "event": "Order Completed",
  "properties": {
    "checkout_id": "70324a1f0eaf000000000000",
    "order_id": "40684e8f0eaf000000000000",
    "affiliation": "Vandelay Games",
    "total": 52,
    "subtotal": 45,
    "revenue": 50,
    "shipping": 4,
    "tax": 3,
    "discount": 5,
    "coupon": "NEWCUST5",
    "currency": "USD",
    "products": [{
        "product_id": "622c6f5d5cf86a4c77358033",
        "sku": "8472-998-0112",
        "name": "Cones of Dunshire",
        "price": 40,
        "position": 1,
        "category": "Games",
        "url": "https://www.website.com/product/path",
        "image_url": "https://www.website.com/product/path.jpg"
      },
      {
        "product_id": "577c6f5d5cf86a4c7735ba03",
        "sku": "3309-483-2201",
        "name": "Five Crowns",
        "price": 5,
        "position": 2,
        "category": "Games"
      }
    ]
  }
}'
```
{{% /tab %}}
{{% tab tabName="HTTP" %}}

```http
POST /v1/track HTTP/1.1
Host: <DATA_PLANE_URL>
Content-Type: application/json
Authorization: Basic <token>
Content-Length: 908

{
  "userId": "user123",
  "event": "Order Completed",
  "properties": {
    "checkout_id": "70324a1f0eaf000000000000",
    "order_id": "40684e8f0eaf000000000000",
    "affiliation": "Vandelay Games",
    "total": 52,
    "subtotal": 45,
    "revenue": 50,
    "shipping": 4,
    "tax": 3,
    "discount": 5,
    "coupon": "NEWCUST5",
    "currency": "USD",
    "products": [{
        "product_id": "622c6f5d5cf86a4c77358033",
        "sku": "8472-998-0112",
        "name": "Cones of Dunshire",
        "price": 40,
        "position": 1,
        "category": "Games",
        "url": "https://www.website.com/product/path",
        "image_url": "https://www.website.com/product/path.jpg"
      },
      {
        "product_id": "577c6f5d5cf86a4c7735ba03",
        "sku": "3309-483-2201",
        "name": "Five Crowns",
        "price": 5,
        "position": 2,
        "category": "Games"
      }
    ]
  }
}
```
{{% /tab %}}
{{< /tabs >}}

### Event payload seen in Live Events

The final event payload as seen in the destination's [Live Events]({{< ref "monitor/live-events.md" >}}) console is shown below:

{{< tabs tabTotal="3" >}}
{{% tab tabName="JSON" %}}
```json
{
    "version": "1",
    "type": "REST",
    "method": "POST",
    "endpoint": "https://example.com/path/user123", // Path settings
    "headers": {
        "header": "header_value", // Header settings
        "Content-Type": "application/json"
    },
    "params": {
        "key": "value" // Query parameter settings
    },
    "body": {
        "JSON": {  // Request body settings
            "event": "Order Completed",
            "currency": "USD",
            "userId": "user123"
        },
        "JSON_ARRAY": {},
        "XML": {},
        "FORM": {}
    },
    "files": {}
}
```

The live event seen in the RudderStack dashboard is shown:

{{< figure src="images/event-stream-destinations/json-event-payload.webp" alt="Sample JSON payload sent to webhook" >}}

{{% /tab %}}
{{% tab tabName="XML" %}}
```json
{
    "version": "1",
    "type": "REST",
    "method": "POST",
    "endpoint": "https://example.com/path/user123", // Path settings
    "headers": {
        "header": "header_value", // Header setting
        "Content-Type": "application/xml"
    },
    "params": {
        "key": "value" // Query parameter settings
    },
    "body": {
        "JSON": {},
        "JSON_ARRAY": {},
        "XML": {  // Request body settings
            "payload": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><root><event>Order Completed</event><currency>USD</currency><userId>user123</userId></root>"  
        },
        "FORM": {}
    },
    "files": {}
}
```

The live event seen in the RudderStack dashboard is shown:

{{< figure src="images/event-stream-destinations/xml-event-payload.webp" alt="Sample event payload sent to webhook" >}}

{{% /tab %}}
{{% tab tabName="FORM" %}}
```json
{
    "version": "1",
    "type": "REST",
    "method": "POST",
    "endpoint": "https://example.com/path/user123", // Path settings
    "headers": {
        "header": "header_value", // Header settings
        "Content-Type": "application/x-www-form-urlencoded"
    },
    "params": {
        "key": "value" // Query parameter settings
    },
    "body": {
        "JSON": {},
        "JSON_ARRAY": {},
        "XML": {},
        "FORM": { // Request body settings
            "event": "Order Completed",
            "currency": "USD",
            "userId": "user123"
        }
    },
    "files": {}
}
```

The live event seen in the RudderStack dashboard is shown:

{{< figure src="images/event-stream-destinations/form-event-payload.webp" alt="Sample event payload sent to webhook" >}}

{{% /tab %}}
{{< /tabs >}}

### Request sent to the destination

This section contains the final CURL request sent from RudderStack to the webhook destination:

{{< tabs tabTotal="3" >}}
{{% tab tabName="JSON" %}}
```bash
curl -X POST "https://example.com/path/user123?key=value" \
  -H "header: header_value" \
  -H "Content-Type: application/json" \
  -d '{"event":"Order Completed","currency":"USD","userId":"user123"}'
```
{{% /tab %}}
{{% tab tabName="XML" %}}
```bash
curl -X POST "https://example.com/path/user123?key=value" \
  -H "header: header_value" \
  -H "Content-Type: application/xml" \
  -d '<?xml version="1.0" encoding="UTF-8"?><root><event>Order Completed</event><currency>USD</currency><userId>user123</userId></root>'
```
{{% /tab %}}
{{% tab tabName="Form" %}}
```bash
curl -X POST "https://example.com/path/user123?key=value" \
  -H "header: header_value" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "event=Order%20Completed&currency=USD&userId=user123"
``` 
{{% /tab %}}
{{< /tabs >}}