Linking Helpin as a source
Let AI connect your sources for you
Skip the manual setup — run this in your project and the wizard auto-detects your databases and APIs and connects them to PostHog.

The Helpin connector syncs your Helpin customer support and project management data – support conversations, CRM contacts, tasks, epics, teams, documents, and more – into the PostHog data warehouse.
Prerequisites
You need a Helpin workspace with API access enabled. A workspace manager creates a service account under Settings > MCP access > Service accounts, then generates a token for it. The token starts with hmp_ and is shown only once.
Grant the service account read scopes for the tables you want to sync:
helpin.support.read– support conversations, messages, inboxes, and tagshelpin.crm.read– contacts, companies, deals, and pipelineshelpin.pm.read– tasks, epics, sprints, objectives, labels, and workflowshelpin.docs.read– documentshelpin.context.read– teams and members
The service account can be read-only. For self-hosted Helpin instances, you also need the API host URL. It must use HTTPS.
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 Helpin.
- Enter your API token (starts with
hmp_). - If you use a self-hosted Helpin instance, enter your API host. Leave this blank for Helpin Cloud.
- 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 Helpin data in PostHog.
Available tables
| Table | Description | Sync method |
|---|---|---|
support_conversations | Support conversations in the Helpin inbox, from email, chat, and other channels | Full refresh |
support_conversation_messages | Public messages in each support conversation, oldest first | Full refresh |
support_inboxes | Support inboxes and mailboxes with conversation counts | Full refresh |
support_tags | Tags for support conversations | Full refresh |
crm_contacts | CRM contacts with custom properties | Full refresh |
crm_companies | CRM companies with custom properties | Incremental |
crm_deals | CRM deals with stage name and amount | Full refresh |
crm_pipelines | CRM deal pipelines with ordered stages | Full refresh |
tasks | Project tasks, including completed and archived tasks | Incremental |
epics | Epics with state, owner, dates, health, and progress counts | Full refresh |
sprints | Sprints with dates, status, and progress counts | Full refresh |
objectives | Objectives with type, state, owners, linked epics, and progress | Full refresh |
labels | Workspace and team labels for tasks, epics, and objectives | Full refresh |
workflows | The workflow each team uses with ordered states | Full refresh |
teams | Teams in the workspace | Full refresh |
members | Active workspace members with roles and teams | Full refresh |
documents | Docs documents with status, space, and collection | Full refresh |
Incremental tables (tasks and crm_companies) sync only new or updated records based on updated_at. These tables re-read at least one day of overlap to account for Helpin's date-based filtering. Full refresh tables reload all data on each sync.
Configuration
| Option | Type | Required |
|---|---|---|
API token | password | Yes |
API host (optional) | text | No |
Supported tables
| Table | Description | Sync method | Incremental field | Primary key |
|---|---|---|---|---|
support_conversations | Support conversations in the Helpin inbox, from email, chat and other channels. Merged conversations and conversations that are snoozed at sync time are not listed. | Full refresh | — | — |
support_conversation_messages | Public messages in each support conversation, oldest first. Internal notes are not included. | Full refresh | — | — |
support_inboxes | Support inboxes: the shared inbox and each mailbox, with their conversation counts at sync time. At most 100 are listed. | Full refresh | — | — |
support_tags | Tags for support conversations. At most 100 are listed. | Full refresh | — | — |
crm_contacts | CRM contacts in the workspace, with their custom properties. | Full refresh | — | — |
crm_companies | CRM companies in the workspace, with their custom properties. | Incremental, Full refresh | updated_at | — |
crm_deals | CRM deals with their stage name and amount. | Full refresh | — | — |
crm_pipelines | CRM deal pipelines with their ordered stages. At most 100 are listed. | Full refresh | — | — |
tasks | Project tasks, including completed and archived tasks. | Incremental, Full refresh | updated_at | — |
epics | Epics with their state, owner, dates, health and progress counts. | Full refresh | — | — |
sprints | Sprints with their dates, status and progress counts. | Full refresh | — | — |
objectives | Objectives with their type, state, owners, linked epics and progress. | Full refresh | — | — |
labels | Workspace and team labels for tasks, epics and objectives. Archived labels are not listed. | Full refresh | — | — |
workflows | The workflow each team uses, with its ordered states. One row per team. | Full refresh | — | — |
teams | Teams in the workspace. | Full refresh | — | — |
members | Active workspace members with their role and teams. Email addresses are not included. | Full refresh | — | — |
documents | Docs documents with their status, space and collection, including archived documents. The document body is not included. | Full refresh | — | — |





