# SurveyMonkey

The SurveyMonkey piece in ZBrain Flow allows seamless integration with SurveyMonkey’s survey management and data collection features. This component enables users to automate survey-related tasks, retrieve survey responses, and interact with SurveyMonkey’s API directly within their workflows. With SurveyMonkey integration, you can streamline survey distribution, automate data analysis, and enhance decision-making by incorporating real-time feedback into your workflow processes.

### **How to Use SurveyMonkey in ZBrain Flow** <a href="#how-to-use-surveymonkey-in-zbrain-flow" id="how-to-use-surveymonkey-in-zbrain-flow"></a>

**Select SurveyMonkey as Your Connection**

1. Click on the ‘+’ button in the Flow.
2. Search for SurveyMonkey and select it.
3. Choose the action you want to perform. For SurveyMonkey, ZBrain Flow provides the following action:
   * **Custom API Call** – Send a request to a specific SurveyMonkey API endpoint.

### **How to Send a Request to a Specific SurveyMonkey API Endpoint** <a href="#how-to-send-a-request-to-a-specific-surveymonkey-api-endpoint" id="how-to-send-a-request-to-a-specific-surveymonkey-api-endpoint"></a>

**Step 1: Configure the Custom API Call**

1. In the ‘Connection’ dropdown, click on 'create connection'.
2. A small window will appear. Fill in the following details to create a connection:
   * **‘Connection Name’ –** Enter a name for this connection.
   * **‘Redirect URL’ –** Provide the redirect URL used during authentication to authorize the connection securely.
   * **‘Client ID’ –** Enter your SurveyMonkey Client ID.
   * **‘Client Secret’ –** Enter your SurveyMonkey Client Secret.
3. Click ‘Connect’, then ‘Save’.

**Step 2: Set Up the API Request**

1. In the ‘URL’ field, enter the base URL for SurveyMonkey's API: '<https://api.surveymonkey.com/v3>'. This is the root endpoint for making requests. Add the specific API endpoint, such as '/models'.
2. From the ‘Method’ dropdown, choose the HTTP method (GET, POST, etc.).

**Step 3: Configure Request Parameters**

1. Headers – Click ‘Add Item’ if you need to add custom headers. Note that authorization headers are injected automatically from your connection.
2. Query Parameters – Click ‘Add Item’ to add any query parameters needed for the API request.
3. Body – Add request body content if required.

**Step 4: Set Additional Options**

1. ‘No Error on Failure’ – Enable this if you want the workflow to continue even if the API call fails.
2. ‘Timeout (in seconds)’ – Set a timeout limit for the request.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zbrain.ai/zbrain-documentation/zbrain-builder/flows/flow-components/surveymonkey.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.