Linking Plain as a source
Alpha release
This source is currently in alpha. The interface and available tables may change.
The Plain connector automatically pulls your Plain customer support data – customers, threads, and timeline entries – 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 Plain.
- Next, you need an API key from Plain. In your Plain workspace settings, create an API key. Make sure to grant the following read permissions:
customer:read,thread:read, andtimeline:read. Copy the key value (it starts withplainApiKey_). - Back in PostHog, enter the API key in the
API keyfield 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 Plain data in PostHog.
Available tables
| Table | Description | Sync method |
|---|---|---|
customers | Customers in your Plain workspace | Incremental |
threads | Support threads (conversations) | Incremental |
timeline_entries | Timeline entries (chats, emails, notes, and custom entries) for each thread | Incremental |
Incremental tables sync only new or updated records on each run. Full refresh tables reload all data on each sync.
Configuration
| Option | Type | Required |
|---|---|---|
API key | password | Yes |
Supported tables
| Table | Description | Sync method | Incremental field | Primary key |
|---|---|---|---|---|
customers | A customer in Plain — a person who contacts your support team. | Incremental, Full refresh | updatedAt | — |
threads | A support conversation (thread) between a customer and your team in Plain. | Incremental, Full refresh | updatedAt | — |
timeline_entries | An event on a thread's timeline in Plain — a chat, email, or note entry. | Incremental, Full refresh | createdAt | — |