## SurveyMonkey integration

SurveyMonkey is an online survey platform for creating, distributing, and analyzing surveys and questionnaires. The SurveyMonkey integration with Frontegg allows your application to access and manage surveys, responses, and collectors on behalf of your users.

Prerequisites
- A SurveyMonkey account with access to the developer portal
- Permission to create apps in the [SurveyMonkey Developer Portal](https://developer.surveymonkey.com/)


### Connect SurveyMonkey

#### Step 1: Open My Apps and create a new app

Sign in to the [SurveyMonkey Developer Portal](https://developer.surveymonkey.com/) and click **My Apps** in the top navigation. Click **Add a New App** to open the app creation dialog.

![My Apps page with Add a New App button highlighted](/assets/surveymonkey-1.c4130c7915790489428dc6039403c470550aadae19cc47fe7e31a8f3a5da73dd.1ce25488.png)

#### Step 2: Fill in the app creation form

In the dialog that appears, fill in the following fields:

- **App Nickname**: `Frontegg Integration`
- **App Creator**: your email address
- **App Type**: Select **Private App**


Click **Create App**.

![App creation dialog with Private App selected and Create App button highlighted](/assets/surveymonkey-2.809b7b96fa1748bf5d6c49361b775193e3f0237448a91034eb6ff38c7c9f9a9c.1ce25488.png)

#### Step 3: Copy your credentials

After creation, you are taken to the **Overview** tab. Copy the **Client ID** and **Client Secret** values and store them securely.

Save your credentials
Copy your Client ID and Client Secret immediately. You will need them to configure the integration in the Frontegg portal.

![App overview showing Client ID and Client Secret fields](/assets/surveymonkey-3.c53036acb6f89a39ad952035854febc38a727b6e2005456a6fd04ec05438b74d.1ce25488.png)

#### Step 4: Configure OAuth redirect URLs

Click the **SETTINGS** tab. In the **OAuth Redirect URL** field, enter the Frontegg callback URL:

`https://YOUR_MCP_GATEWAY_URL/integration-callback`

Click **Submit Changes**.

![Settings page showing OAuth Redirect URL configured](/assets/surveymonkey-4.fa6cc8bfe613c46d94066b97491b1c5ecbacac7f919265c14896fa25abfdc6a7.1ce25488.png)

#### Step 5: Configure scopes

Scroll down to the **Scopes** section. Click each of the following scopes to set them to **Required**:

| Scope | Description |
|  --- | --- |
| `Create/Modify Surveys` | Create and modify surveys |
| `View Surveys` | Read survey information |
| `View Collectors` | Read collector information |
| `Create/Modify Responses` | Modify survey responses |
| `View Responses` | Read survey responses |


Click **Update Scopes** to save.

![Scopes section showing five required scopes highlighted](/assets/surveymonkey-5.7fb317c0c7904095a2d008dd7ca21e9aa1c7273ca18dbe1316209db239a072eb.1ce25488.png)

### Configure the Frontegg portal

Once you have your **Client ID** and **Client Secret** from the Overview tab, enter them in the Frontegg portal:

1. Open the **Frontegg portal** and navigate to your environment → **Integrations** → **SurveyMonkey**.
2. Enter the **Client ID** and **Client Secret** in the corresponding fields.
3. Click **Save**.


Keep your credentials secure
Never share or commit your Client Secret to version control.

### Additional resources

- [SurveyMonkey API documentation](https://developer.surveymonkey.com/api/v3/)
- [SurveyMonkey developer portal](https://developer.surveymonkey.com/)
- [SurveyMonkey OAuth scopes reference](https://developer.surveymonkey.com/api/v3/#scopes)
- [How to get your Redirect URL](/agen-for-work/connectors/redirect-url)