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.

Learn more
PostHog Wizard hedgehog

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 tags
  • helpin.crm.read – contacts, companies, deals, and pipelines
  • helpin.pm.read – tasks, epics, sprints, objectives, labels, and workflows
  • helpin.docs.read – documents
  • helpin.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

  1. Go to the sources tab of the data pipeline section in PostHog.
  2. Click + New source and then click Link next to Helpin.
  3. Enter your API token (starts with hmp_).
  4. If you use a self-hosted Helpin instance, enter your API host. Leave this blank for Helpin Cloud.
  5. Click Next.
  6. 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

TableDescriptionSync method
support_conversationsSupport conversations in the Helpin inbox, from email, chat, and other channelsFull refresh
support_conversation_messagesPublic messages in each support conversation, oldest firstFull refresh
support_inboxesSupport inboxes and mailboxes with conversation countsFull refresh
support_tagsTags for support conversationsFull refresh
crm_contactsCRM contacts with custom propertiesFull refresh
crm_companiesCRM companies with custom propertiesIncremental
crm_dealsCRM deals with stage name and amountFull refresh
crm_pipelinesCRM deal pipelines with ordered stagesFull refresh
tasksProject tasks, including completed and archived tasksIncremental
epicsEpics with state, owner, dates, health, and progress countsFull refresh
sprintsSprints with dates, status, and progress countsFull refresh
objectivesObjectives with type, state, owners, linked epics, and progressFull refresh
labelsWorkspace and team labels for tasks, epics, and objectivesFull refresh
workflowsThe workflow each team uses with ordered statesFull refresh
teamsTeams in the workspaceFull refresh
membersActive workspace members with roles and teamsFull refresh
documentsDocs documents with status, space, and collectionFull 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

OptionTypeRequired
API tokenpasswordYes
API host (optional)textNo

Supported tables

TableDescriptionSync methodIncremental fieldPrimary 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 refreshupdated_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 refreshupdated_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——

Still have questions?

Was this page useful?