SurveyMonkey

SurveyMonkey: Overview and setup

Connect SurveyMonkey to automate surveys, and collect employee feedback easily.

The SurveyMonkey integration allows you to easily collect feedback from employees, create and manage surveys, distribute them via web links or email and collect responses directly from Atomicwork.

You can automate employee satisfaction surveys, use pre-built templates for standardized feedback collection, and retrieve responses for further processing. This streamlines feedback loops and enables data-driven decisions based on employee input.

Usecases

By connecting SurveyMonkey, your teams can build:

Employee feedback workflows: Automatically create and distribute employee satisfaction surveys as part of onboarding, offboarding, or periodic reviews.
Template-based surveys: Use pre-built SurveyMonkey templates to quickly create standardized surveys like NPS or CSAT.
Survey distribution: Send surveys via email or generate shareable web links.
Response collection and analysis: Retrieve survey responses in bulk for analysis or to trigger further workflows based on feedback.
Self-service survey requests: Allow employees or managers to request survey creation through Atom.

Permissions

To connect SurveyMonkey to Atomicwork, you need:

Org admin access in Atomicwork
A SurveyMonkey account billed on the Advantage plan or higher with the necessary scopes.

The integration uses OAuth 2.0 authentication with the following scopes:

OAuth Scope	Purpose
surveys_read	Required for listing surveys, getting survey details, and survey dropdown selection. Provides read access to surveys.
surveys_write	Required for creating surveys, creating surveys from templates, and updating surveys. Provides write access to surveys.
collectors_read	Required to read collector status and URLs after creation. Provides read access to collectors.
collectors_write	Required for sending surveys via email collectors and creating weblink collectors. Provides write access to collectors.
responses_read	Required to retrieve survey response data in summary format. Provides read access to survey responses.
responses_read_detail	Required to retrieve full expanded response data including individual answers. Provides read access to detailed survey responses.
library_read	Required for creating surveys from templates and template dropdown selection. Provides read access to the SurveyMonkey template library.

Setup

Navigate to Settings > App Store > SurveyMonkey.
Click on Connect.
Authenticate using OAuth 2.0 by providing your SurveyMonkey credentials.
Grant the required permissions to allow Atomicwork to manage surveys, collectors, and responses.

[!NOTE] SurveyMonkey access tokens are long-lived and do not expire. You will not need to re-authenticate unless you revoke access in your SurveyMonkey settings.

Supported workflow actions

Once connected, you can automate the following SurveyMonkey actions within your Atomicwork workflows:

Action	Description
Create survey	Create a new blank survey with title, nickname, and language.
Create survey from template	Create a survey from a SurveyMonkey template or existing survey.
Update survey	Update an existing survey's title, nickname, or language.
Send survey	Create an email collector to send a survey via email invitations.
Create weblink collector	Create a web link collector and get a shareable URL.
Get survey details	Get expanded survey details including pages, questions, and response counts.
Get survey responses	Retrieve expanded survey responses in bulk.
List surveys	List all surveys with pagination and search.
Call API	Execute a generic API call to any SurveyMonkey endpoint.

Troubleshooting

If you encounter issues while setting up or using the integration, review the following common scenarios:

If you encounter issues while using the SurveyMonkey integration, review the following common errors:

Error	Cause	Resolution
"access_token is null"	The OAuth flow did not complete successfully or the configuration is corrupted.	Re-authenticate the integration by reconnecting your SurveyMonkey account.
4xx Client Error during token exchange	The authorization code may have expired or the redirect URI doesn't match.	Re-initiate the OAuth flow by reconnecting the integration.
5xx Server Error during token exchange	SurveyMonkey API may be experiencing issues.	Retry the connection later. Check the SurveyMonkey API status page.
Insufficient scopes or plan level errors	Your SurveyMonkey account doesn't have the required plan level for certain API features (e.g., detailed responses).	Ensure your SurveyMonkey account has an Advantage plan or higher for full API access.
Token stopped working	You likely revoked access in your SurveyMonkey settings.	Re-authenticate the integration. SurveyMonkey tokens are long-lived and don't expire automatically.