How to integrate SurveyMonkey with Sapho version 4.2 or greater

Last update:

Important Notes

1. We recommend creating a dedicated SurveyMonkey account (for example, sapho@company.com) and then using it to set up the SurveyMonkey connector in Sapho. This account must have full data access privileges.

2. If your internal server hosting Sapho is behind a firewall, you will need to allow access to hostname www.surveymonkey.com with port 443, so Sapho can connect to the SurveyMonkey cloud.

 

In order to integrate SurveyMonkey with Sapho, you will first need to supply a client ID and client secret.

Here’s how to get your client ID and client secret in SurveyMonkey:

Step 1: Go to Developers section on SurveyMonkey

If you are not logged into SurveyMonkey, click on Developers at the bottom of the page.

developers-link.png

If you are already logged into SurveyMonkey, you can go to Developer section here

Step 2: Sign into SurveyMonkey

Log into www.surveymonkey.com with the dedicated user account.

Step 3: Go to My Apps section

my-apps-link.png 

Click Add New App to create a new app. Select an app type in theApp Creation dialog. You can compare a private app and a public app for the App Directory in SurveyMonkey's developer documentation.

create-app-dialog.png

Alternatively, you can also use an existing app by clicking on Overview of the app you would like to use.

existing-app.png

Step 4: Get Client ID and Secret

Copy your Client ID and Secret from the app overview window and paste them in a secure place for later reference.

new-app-information.png

Step 5: Set OAuth Redirect URL and application scope

To set up app access with OAuth authentication, click on Settings tab in the app detail. Enter an App Nickname and set the OAuth Redirect URL to https://auth.sapho.com/callback. Click Submit Changes to confirm your app settings.

update-redirect-url.png

Use the following requirements to set the scope of your application:

app-scopes.png

Private apps are subject to SurveyMonkey API rate limits, which allows 500 requests per day by default. For more details, please visit SurveyMonkey's API documentation.

Step 6: Paste the credentials in Sapho

Enter the Client ID and Secret you obtained at Step 4 in the connector configuration form for SurveyMonkey in Sapho. Click Next.

Step 7: Log in with the dedicated SurveyMonkey account

Click Next.

Step 8: Finish the creation of the connector