Skip to main content

Authorization

Follow this guide to create a new SurveyMonkey credential that will allow Nexla to authenticate to and exchange data with your SurveyMonkey account.
surveymonkey_api_auth.png

Survey Monkey

Prerequisites​

Before creating a SurveyMonkey credential, you need to register a Private App in your SurveyMonkey account and obtain your Client ID and Client Secret. SurveyMonkey uses OAuth2 3-legged authentication for all API requests, requiring user authorization to obtain an access token.

To obtain your SurveyMonkey credentials, follow these steps:

  1. Sign in to your SurveyMonkey account using your administrator credentials.

  2. Navigate to your account settings or developer section in the SurveyMonkey interface.

  3. Look for the Apps or My Apps section in your account settings, or navigate to Settings > Apps or Developer > My Apps.

  4. Click Create App or Register New App to create a new Private App for API access.

  5. Select Private App as the app type. Private Apps are used for accessing your own SurveyMonkey data.

  6. Configure your Private App settings:

    • Enter a name for the app (e.g., "Nexla Integration")
    • Enter an app description (optional)
    • Review and select the permissions or scopes for the app (if applicable)

  7. Click Create or Register to create the Private App.

  8. After the app is created, you will be provided with your Client ID and Client Secret. Copy both credentials immediately, as the Client Secret may not be accessible again after you navigate away from the page.

  9. Store both credentials securely, as you will need them to configure your Nexla credential. The Client ID and Client Secret are sensitive information and should be kept confidential.

The Client ID and Client Secret are used in the OAuth2 3-legged authorization flow. During credential creation in Nexla, you will be redirected to SurveyMonkey to authorize the application. After authorization, SurveyMonkey will provide an access token that is used in the Authorization: Bearer {token} header for all API requests to the SurveyMonkey API. The token authenticates your requests and grants access to SurveyMonkey resources based on your account permissions. If your credentials are compromised, you should immediately revoke them in your SurveyMonkey account settings and generate new ones. For detailed information about registering Private Apps, OAuth2 authentication, and available endpoints, refer to the SurveyMonkey API documentation.

Create a SurveyMonkey Credential​

  • To create a new SurveyMonkey credential, after selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

New Credential Overlay – SurveyMonkey

SurveyMonkeyCred.png

Credential Name & Description​

  1. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

    Resource descriptions are recommended but are not required. They should be used provide information about the resource purpose, data freshness, etc. that can help the owner and other users efficiently understand and utilize the resource.

OAuth2 3-Legged Authentication​

SurveyMonkey uses OAuth2 3-legged authentication for all API requests. The Client ID and Client Secret are used to initiate the OAuth2 authorization flow, which requires user authorization to obtain an access token.

  1. Enter your SurveyMonkey Client ID in the Client ID field. This is the Client ID you obtained from your SurveyMonkey account settings (Settings > Apps > My Apps > [Your App]) when creating your Private App. The Client ID is used along with the Client Secret to initiate the OAuth2 authorization flow.

  2. Enter your SurveyMonkey Client Secret in the Client Secret field. This is the Client Secret you obtained from your SurveyMonkey account settings when creating your Private App. The Client Secret is used along with the Client ID to initiate the OAuth2 authorization flow. The Client Secret is sensitive information and must be kept confidential.

  3. After entering your Client ID and Client Secret, click Authorize or Connect to initiate the OAuth2 authorization flow. You will be redirected to SurveyMonkey to authorize the application.

  4. Sign in to your SurveyMonkey account if prompted, and review the permissions requested by the application.

  5. Click Authorize or Allow to grant the application access to your SurveyMonkey account.

  6. After authorization, you will be redirected back to Nexla, and the access token will be automatically configured for your credential.

    Your SurveyMonkey OAuth credentials can be found in your SurveyMonkey account settings under Settings > Apps > My Apps > [Your App]. The Client ID and Client Secret are generated when you create a Private App.

    These credentials are used to initiate the OAuth2 3-legged authorization flow. During credential creation, you will be redirected to SurveyMonkey to authorize the application. After authorization, SurveyMonkey will provide an access token that is used in the Authorization: Bearer {token} header for all API requests to the SurveyMonkey API.

    If your credentials are compromised, you should immediately revoke them in your SurveyMonkey account settings and generate new ones. The credentials provide access to your SurveyMonkey account data and should be treated as sensitive information. Keep your credentials secure and do not share them publicly.

    For detailed information about registering Private Apps, OAuth2 authentication, and available endpoints, see the SurveyMonkey API documentation and OAuth 2.0 Flow documentation.

Save the Credential​

  1. Once all of the relevant steps in the above sections have been completed, click the Save button at the bottom of the overlay to save the configured credential.

  2. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation and can be selected for use with a new data source or destination.