Other Integrations
SurveyMonkey
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. |