Send PostHog event data using webhooks

With webhook destinations, you can send event data from PostHog to any HTTP endpoint, whether it's to your own backend, an internal system, or a third-party platform.

Requirements

Using this requires either PostHog Cloud with the data pipelines add-on, or a self-hosted PostHog instance running a recent version of the Docker image.

Setting up destination webhooks

1. Create a new destination

In PostHog, navigate to the data pipelines section in the sidebar. Click + New > Destination in the top-right corner. Search for "Webhook" then click + Create.

2. Configure the webhook

On the configuration page, enter a Webhook URL. This is the HTTP endpoint that will receive the event data from PostHog. By default, PostHog sends a POST request with a templated JSON body.

Click Create & Enable.

3. Test the webhook

Now that the webhook is enabled, let's see it in action. In the Testing section of the configuration page, click Start testing > Test function to send an example event.

You should see the webhook endpoint receive a POST request with event data.

4. Customize the webhook (optional)

You can further configure and customize webhook destinations by:

• Adding filters, match rules, and trigger options in the Filters section
• Customizing the payload
• Using global variables
• Modifying the source code in the Edit source section

# Create a new destination
curl --location 'https://us.i.posthog.com/api/environments/:project_id/hog_functions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <POSTHOG_PERSONAL_API_KEY>' \
--data '{
    "type": "destination",
    "name": "HTTP Webhook",
    "inputs": {
        "url": {
            "value": ""
        }
    },
    "enabled": true,
    "template_id": "template-webhook"
}'