Linking SurveyMonkey 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.
Contents
The SurveyMonkey connector syncs your survey data into PostHog, including surveys, responses, pages, questions, collectors, trends, messages, recipients, and message stats.
Creating a SurveyMonkey access token
PostHog authenticates with SurveyMonkey using a private app access token.
- Go to the SurveyMonkey developer dashboard and create a private app.
- Generate an access token for your app.
- Grant the following read scopes:
surveys_readresponses_read_detailcollectors_read
- Copy the access token — you'll paste it into PostHog in the next step.
Linking SurveyMonkey
- Go to the Data pipeline sources page in PostHog.
- Click + New source and then click Link next to SurveyMonkey.
- Paste your SurveyMonkey access token.
- Select your data center (US, EU, or Canada) — this must match the region your SurveyMonkey account is hosted in.
- Optional: Add a prefix to your table names.
- 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.
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 | — | — |
survey_trends | Answer counts for each question of a survey, bucketed by day. | Full refresh | — | — |
collector_messages | An email or SMS invite or reminder message sent from a collector. | Full refresh | — | — |
collector_recipients | A contact who gets a collector's email or SMS messages, with their delivery and response status. | Full refresh | — | — |
collector_message_stats | Delivery, open, click, bounce and response counts for one collector message. | 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 | — |
survey_trends | Full refresh | — |
collector_messages | Full refresh | — |
collector_recipients | Full refresh | — |
collector_message_stats | 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 |
survey_trends | Answer counts for each question of a survey, bucketed by day |
collector_messages | An email or SMS invite or reminder message sent from a collector |
collector_recipients | A contact who receives a collector's email or SMS messages, with their delivery and response status |
collector_message_stats | Delivery, open, click, bounce, and response counts for one collector message |
Note: The
collector_messages,collector_recipients, andcollector_message_statstables are only available for email and SMS collectors. Weblink and popup collectors do not have these resources.