oauth_2) or paste a private app’s access token from its settings page as surveymonkey({ key }). A token only reaches the account that authorized it.
Every account starts on https://api.surveymonkey.com/v3, but the token exchange returns an access_url per account and the vendor says an account may live on another datacenter. The EU datacenter is api.eu.surveymonkey.com and the Canadian one is api.surveymonkey.ca. Pass surveymonkey({ apiHost }) or store it as api_host when it differs. Only a surveymonkey.com or surveymonkey.ca host is accepted, so a stored value cannot redirect the token.
Things to know before you call:
- Every id is a string, even when it looks numeric, and every list answers
{ data, page, per_page, total, links }. Readlinks.nextto page. responses.listreturns ids and links only. Useresponses.listBulkfor the answers, up to 100 a page, andresponses.getorresponses.getDetailsfor one.responses.createhangs off a collector, not a survey, because a collector owns the response link.- A question needs
familyandsubtype, which decide the question type, and at least one heading, which is the question text. messages.createonly drafts a message.messages.sendis the call that mails every recipient on it.- A contact needs both names, plus an email or a phone number. The list filter takes
active,optoutorbounced. - The plugin does not receive webhook deliveries yet.
webhooks.*manages subscriptions. SurveyMonkey signs each delivery withSm-Signature, a base64 HMAC-SHA1 over the raw body keyed byclientId&clientSecret; the package exportsverifySurveymonkeySignaturefor checking one in your own receiver. - A draft or private app is limited to 120 requests a minute and 500 a day, reset at midnight GMT.
- 63 typed API operations
Setup
1
Install
2
Add the plugin
corsair.ts
multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.3
Choose authentication
- OAuth 2.0 (Recommended)
Open hub.corsair.dev, navigate to your project, and enter the client ID and client secret from your SurveyMonkey OAuth app.More: OAuth 2.0
4
Connect a tenant
Mint a connect link and send the tenant to it. Hub hosts the page and delivers the result to your app — see Connect / OAuth.
Example API calls
List surveysWhat’s next
API reference
Every
surveymonkey.api.* operation with input and output types.Connect / OAuth
createLink, Hub delivery, and tenant connect flows.
Use with agents
Expose this plugin’s operations as MCP tools.