Webhooks

Posthog incoming webhooks: event paths, payloads, and response data.

The Posthog plugin handles incoming webhooks. Point your provider’s subscription URL at your Corsair HTTP handler (see Overview for setup context and the exact URL shape).

New to Corsair? See webhooks and hooks.

Webhook map

• events
  • captured (events.captured)

HTTP handler setup

app/api/webhook/route.ts

import { processWebhook } from "corsair";
import { corsair } from "@/server/corsair";

export async function POST(request: Request) {
    const headers = Object.fromEntries(request.headers);
    const body = await request.json();
    const result = await processWebhook(corsair, headers, body);
    return result.response;
}

Events

Events

Captured

events.captured

A PostHog event was captured

Payload

Name	Type	Required	Description
event	string	Yes	—
distinct_id	string	Yes	—
timestamp	string	No	—
uuid	string	No	—
properties	object	No	—
person	object	No	—
groups	object	No	—
$set	object	No	—
$set_once	object	No	—
$unset	string[]	No	—

properties full type

{
}

person full type

{
  distinct_id: string,
  properties?: {
  }
}

groups full type

{
}

$set full type

{
}

$set_once full type

{
}

Response data full type

{
  event: string,
  distinct_id: string,
  timestamp?: string,
  uuid?: string,
  properties?: {
  },
  person?: {
    distinct_id: string,
    properties?: {
    }
  },
  groups?: {
  },
  $set?: {
  },
  $set_once?: {
  },
  $unset?: string[]
}

webhookHooks example

posthog({
    webhookHooks: {
        events: {
            captured: {
                before(ctx, args) {
                    return { ctx, args };
                },
                after(ctx, response) {
                },
            },
        },
    },
})

---