Linking Dovetail 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.
This source is currently in alpha. The interface and available tables may change.
The Dovetail connector can link projects, data, docs, highlights, tags, contacts, users, and doc comments from your Dovetail user research repository to PostHog.
To link Dovetail:
Go to the sources tab of the data pipeline section in PostHog.
Click + New source and then click Link next to Dovetail.
You need a personal API key from Dovetail. In the Dovetail app, go to Settings > Account > Personal API keys and generate a new key.
Back in PostHog, paste the API key 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 Dovetail data in PostHog.
Available tables
| Table | Description | Sync mode |
|---|---|---|
Projects | Dovetail projects | Full refresh |
Data | Research data entries | Incremental |
Docs | Research documents | Incremental |
Highlights | Highlights from research | Incremental |
Tags | Tags for organizing content | Full refresh |
Contacts | Research contacts | Full refresh |
Users | Dovetail users | Full refresh |
DocComments | Comments on documents | Full refresh |
Incremental tables sync only new records since the last sync using the created_at field. Full refresh tables reload all data on each sync.
Configuration
| Option | Description |
|---|---|
API keyType: password Required: True | Generate a personal API key from Settings > Account > Personal API keys in Dovetail. |
Supported tables
| Table | Description | Sync method | Incremental field | Primary key |
|---|---|---|---|---|
Projects | A Dovetail project - the top-level container for organizing qualitative research, holding data, docs, highlights, tags, and insights related to a specific research initiative. | Full refresh | — | — |
Data | A piece of research data (interview transcript, note, or other captured customer feedback) stored in Dovetail. Metadata only - the content body is not included and must be fetched via the export endpoint. | Incremental, Full refresh | created_at | — |
Docs | A Dovetail doc - a synthesized research artifact (report, insight, or written analysis). Metadata only - the document body is not included and must be fetched via the export endpoint. | Incremental, Full refresh | created_at | — |
Highlights | A highlight - a tagged excerpt of a transcript or note captured during qualitative analysis, optionally categorized with one or more tags. | Incremental, Full refresh | created_at | — |
Tags | A tag used to categorize highlights during qualitative analysis (e.g. 'Usability Issue', 'Feature Request'). Each tag belongs to a specific project. | Full refresh | — | — |
Contacts | A contact - a research participant or customer tracked in Dovetail's contact management, with custom field values. | Full refresh | — | — |
Users | A user (team member) with access to the Dovetail workspace. | Full refresh | — | — |
DocComments | A comment left on a Dovetail doc, aggregated across every doc in the workspace. | Full refresh | — | — |