> AI agents: this is one page from PostHog's docs. Full index of Markdown docs for LLMs: https://posthog.com/llms.txt

# Linking Dovetail as a source

Canonical URL: https://posthog.com/docs/data-pipelines/sources/dovetail

> **Cloud region:** This page uses US Cloud hosts. For an EU Cloud project, use `https://eu.posthog.com` instead of `https://us.posthog.com` or `https://app.posthog.com` (app host for links).

## On this page

- [Available tables](#available-tables)
- [Configuration](#configuration)
- [Supported tables](#supported-tables)

**Beta release**

This source is currently in **beta**. It works end to end, but you may still hit rough edges. [Let us know](https://us.posthog.com/#panel=support%3Asupport%3Adata_warehouse%3A%3Atrue) if you do.

![](https://res.cloudinary.com/dmukukwp6/image/upload/texture_tan_9608fcca70)

![](https://res.cloudinary.com/dmukukwp6/image/upload/texture_tan_dark_a92b0e022d)

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.

`npx @posthog/wizard warehouse`

![PostHog Wizard hedgehog](https://res.cloudinary.com/dmukukwp6/image/upload/wizard_3f8bb7a240.png)

![](https://res.cloudinary.com/dmukukwp6/image/upload/wizard_3f8bb7a240.png)Let AI connect your sources for you

The Dovetail connector can link projects, data, docs, highlights, tags, contacts, users, and doc comments from your [Dovetail](https://dovetail.com/) user research repository to PostHog.

To link Dovetail:

1.  Go to the [sources tab](https://app.posthog.com/data-management/sources) of the data pipeline section in PostHog.

2.  Click **\+ New source** and then click **Link** next to Dovetail.

3.  You need a personal API key from Dovetail. In the Dovetail app, go to **Settings** > **Account** > **Personal API keys** and generate a new key.

4.  Back in PostHog, paste the API key and click **Next**.

5.  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 key` **Type:** 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 | — | — |
| `Fields` | A custom field definition, listed per project across every project in the workspace. Fields resolve the custom field values carried on data entries and docs, and cover both field set types ('data' and 'doc'). | Full refresh | — | — |