Linking Kustomer as a source
This source is currently in alpha. The interface and available tables may change.
Enter your Kustomer credentials to pull your customer service data – customers, conversations, users, teams, tags, and brands – into the PostHog data warehouse.
Adding a data source
Go to the sources tab of the data pipeline section in PostHog.
Click + New source and then click Link next to Kustomer.
Next, gather your Kustomer credentials:
- Organization name – the subdomain from your Kustomer URL, e.g.
myorgformyorg.kustomerapp.com. You can also paste the full URL and PostHog will extract the subdomain automatically. - API key – create one in Kustomer under Settings → Security → API Keys. Grant read roles for the data you want to sync (e.g.
org.user.read).
This source authenticates with a Bearer token (API key) and requires read access to the endpoints you want to sync.
- Organization name – the subdomain from your Kustomer URL, e.g.
Back in PostHog, enter the credentials and click Next.
Select the tables you want to sync, set the sync method and frequency, then click Import.
Once the syncs are complete, you can start using Kustomer data in PostHog.
Available tables
| Table | Description | Sync method |
|---|---|---|
customers | Customers | Full refresh |
conversations | Conversations | Full refresh |
users | Helpdesk users (agents) | Full refresh |
teams | Teams | Full refresh |
tags | Tags | Full refresh |
brands | Brands | Full refresh |
Incremental tables sync only new or updated records on each run. Full refresh tables reload all data on each sync.
Sync limitations
All Kustomer tables are full refresh only. Kustomer's GET list endpoints have no server-side timestamp filter, so true incremental sync is not currently possible.
Configuration
| Option | Type | Required |
|---|---|---|
Organization name | text | Yes |
API key | password | Yes |
Supported tables
| Table | Description | Sync method | Incremental field | Primary key |
|---|---|---|---|---|
customers | A person or company that interacts with your business — the central record in Kustomer. | Full refresh | — | — |
conversations | A thread of messages and activity between a customer and your support team. | Full refresh | — | — |
users | A member of your Kustomer organization (an agent, admin, or other team member). | Full refresh | — | — |
teams | A group of users in Kustomer used for routing and assignment. | Full refresh | — | — |
tags | A label that can be applied to customers, conversations, or messages to categorize them. | Full refresh | — | — |
brands | A brand identity in Kustomer, used to support multiple products or businesses from one org. | Full refresh | — | — |