Posthog
Getting Started with the PostHog Webhook Integration
The PostHog Webhook Integration lets you send events, people, and company (group) data from PostHog directly into Custify.
This guide covers the essentials to help you get started quickly.
What the Integration Does
Once connected to Posthog, Custify will:
Import Events
- Receives your custom PostHog events
- Maps distinct_id to the customer in Custify
- Attaches all event properties
- Automatically ignores PostHog’s high-volume autocapture and system events (such as $pageview, $autocapture, $rageclick)
Sync People
- Creates or updates customers from PostHog person data
- Maps email, name, and other default fields
- Links people to companies when group data exists
Sync Companies (Groups)
- Converts selected PostHog group types (such as company, organization) into Custify companies
- Syncs all group properties
- Links events and people to the correct company
How to activate the integration
Step 1: Set Up the Webhook in PostHog
Add a webhook in PostHog that points to:
https://your-custify-domain.com/webhook?posthogAccount=<ACCOUNT_ID>
If you use a secret key for authentication, include the header:
x-custify-secret: <SECRET_KEY>
Step 2: Configure Your Integration in Custify
In Custify, define what should be imported:
- People: enable or disable
- Group types: choose which PostHog groups should become Custify companies
- Custom event exclusions: optional list of event names to ignore
Example configuration:
{
"groupTypes": ["company", "organization"],
"eventFilters": {
"excludedEvents": ["your_custom_event"]
}
}
Custify Mapping:
Events
- Imported as Event records
- Linked to the customer
- Linked to the first matching company group
People
- Identified by distinct_id
- Enriched with PostHog person properties
- Linked to companies (if groups are present)
Companies
- Created from any enabled group types
- Populated with PostHog group properties
Step 3: Test the Integration
- Trigger a test event in your product (for example: posthog.capture('Signed Up'))
- In Custify, verify that:
- The person appears under Customers
- A company was created (if group data was sent)
- The event appears in the timeline