---
title: Posthog
slug: posthog
createdAt: 2026-03-13T08:25:32.620Z
---

## 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**

1. Trigger a test event in your product (for example: posthog.capture('Signed Up'))
2. In Custify, verify that:
   - The person appears under Customers
   - A company was created (if group data was sent)
   - The event appears in the timeline

