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

# Linking SurveyMonkey as a source

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

> **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

- [Creating a SurveyMonkey access token](#creating-a-surveymonkey-access-token)
- [Linking SurveyMonkey](#linking-surveymonkey)
- [Configuration](#configuration)
- [Supported tables](#supported-tables)
- [Data centers](#data-centers)
- [Sync modes](#sync-modes)
- [Available tables](#available-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 SurveyMonkey connector syncs your survey data into PostHog, including surveys, responses, pages, questions, and collectors.

## Creating a SurveyMonkey access token

PostHog authenticates with SurveyMonkey using a private app access token.

1.  Go to the [SurveyMonkey developer dashboard](https://developer.surveymonkey.com/apps/) and create a private app.
2.  Generate an access token for your app.
3.  Grant the following read scopes:
    -   `surveys_read`
    -   `responses_read_detail`
    -   `collectors_read`
4.  Copy the access token — you'll paste it into PostHog in the next step.

## Linking SurveyMonkey

1.  Go to the [Data pipeline sources page](https://app.posthog.com/data-management/sources) in PostHog.
2.  Click **\+ New source** and then click **Link** next to SurveyMonkey.
3.  Paste your SurveyMonkey **access token**.
4.  Select your **data center** (US, EU, or Canada) — this must match the region your SurveyMonkey account is hosted in.
5.  *Optional:* Add a prefix to your table names.
6.  Click **Next**, choose the tables you want to sync, and then click **Import**.

The data warehouse then starts syncing your SurveyMonkey data. You can see details and progress in the [data pipeline sources tab](https://app.posthog.com/data-management/sources).

## Configuration

| Option | Type | Required |
| --- | --- | --- |
| `Access token` | password | Yes |
| `Data center` | select | Yes |

## Supported tables

| Table | Description | Sync method | Incremental field | Primary key |
| --- | --- | --- | --- | --- |
| `surveys` | A survey in your SurveyMonkey account, with its title, structure, and response counts. | Incremental, Full refresh | date\_modified | — |
| `survey_responses` | An individual respondent's submission to a survey, including their answers. | Incremental, Full refresh | date\_modified, date\_created | — |
| `survey_pages` | A page within a survey that groups a set of questions. | Full refresh | — | — |
| `survey_questions` | A question on a survey, extracted from the survey's page details. | Full refresh | — | — |
| `collectors` | A method used to distribute a survey and gather responses (e.g. a web link or email invitation). | Full refresh | — | — |

## Data centers

SurveyMonkey hosts data in regional data centers. Select the region that matches your SurveyMonkey account:

| Region | API host |
| --- | --- |
| US | `api.surveymonkey.com` |
| EU | `api.eu.surveymonkey.com` |
| Canada | `api.surveymonkey.ca` |

If you're unsure which data center your account uses, check your SurveyMonkey account settings or the URL you use to log in.

## Sync modes

SurveyMonkey tables support different sync modes depending on whether the SurveyMonkey API exposes server-side timestamp filters for the resource:

| Table | Sync mode | Incremental filter |
| --- | --- | --- |
| `surveys` | Incremental | `start_modified_at` (cursor: `date_modified`) |
| `survey_responses` | Incremental | `start_modified_at` / `start_created_at` |
| `survey_pages` | Full refresh | — |
| `survey_questions` | Full refresh | — |
| `collectors` | Full refresh | — |

-   **Incremental** – Only imports records modified (or created) since the last sync. More efficient for large accounts.
-   **Full refresh** – Re-imports all records on every sync. Used for tables where the API doesn't support server-side date filtering.

## Available tables

| Table | Description |
| --- | --- |
| `surveys` | List of all surveys in your account |
| `survey_responses` | Individual response data for each survey |
| `survey_pages` | Pages within each survey |
| `survey_questions` | Questions within each survey (extracted from survey details) |
| `collectors` | Collectors (distribution channels) for each survey |