:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
import { HogFunctionTemplate } from '~/cdp/types'
export const template: HogFunctionTemplate = {
free: false,
status: 'alpha',
type: 'source_webhook',
id: 'template-source-webhook',
name: 'HTTP Incoming Webhook',
description: 'Capture an event via a custom incoming webhook',
icon_url: '/static/services/webhook.svg',
category: ['Custom'],
code_language: 'hog',
code: `
if(inputs.debug) {
print('Incoming request:', request.body)
}
if(request.method != inputs.method) {
return {
'httpResponse': {
'status': 405,
'body': 'Method not allowed'
}
}
}
if(notEmpty(inputs.auth_header) and notEquals(inputs.auth_header, request.headers['authorization'])) {
print('Incoming request denied due to bad authorization header')
return {
'httpResponse': {
'status': 401,
'body': 'Unauthorized',
}
}
}
if(empty(inputs.event)) {
return {
'httpResponse': {
'status': 400,
'body': {
'error': '"event" could not be parsed correctly',
}
}
}
}
if(empty(inputs.distinct_id)) {
return {
'httpResponse': {
'status': 400,
'body': {
'error': '"distinct_id" could not be parsed correctly',
}
}
}
}
postHogCapture({
'event': inputs.event,
'distinct_id': inputs.distinct_id,
'properties': inputs.properties
})
`,
inputs_schema: [
{
key: 'event',
type: 'string',
label: 'Event name',
default: '{request.body.event}',
secret: false,
required: true,
},
{
key: 'distinct_id',
type: 'string',
label: 'Distinct ID',
description: 'The distinct ID this event should be associated with',
default: '{request.body.distinct_id}',
secret: false,
required: true,
},
{
key: 'properties',
type: 'json',
label: 'Event properties',
description: 'A mapping of the incoming webhook body to the PostHog event properties',
default: {
$ip: '{request.ip}',
$lib: 'posthog-webhook',
$source_url: '{source.url}',
},
secret: false,
required: false,
},
{
key: 'auth_header',
type: 'string',
label: 'Authorization header value',
description:
'If set, the incoming Authorization header must match this value exactly. e.g. "Bearer SECRET_TOKEN"',
secret: true,
required: false,
},
{
key: 'method',
type: 'choice',
label: 'Method',
secret: false,
choices: [
{
label: 'POST',
value: 'POST',
},
{
label: 'PUT',
value: 'PUT',
},
{
label: 'PATCH',
value: 'PATCH',
},
{
label: 'GET',
value: 'GET',
},
{
label: 'DELETE',
value: 'DELETE',
},
],
default: 'POST',
required: false,
description: 'HTTP method to allow for the request.',
},
{
key: 'debug',
type: 'boolean',
label: 'Log payloads',
description: 'Logs the incoming request for debugging',
secret: false,
required: false,
default: false,
},
],
}