SurveySparrow

SurveySparrow is a survey and feedback platform for building NPS, CSAT, and conversational forms. This connector uses the SurveySparrow REST API (v3) to read surveys, questions, responses, contacts, and folders, and to create or update those same resources, so you can move feedback data into and out of Nexla flows.

Power end-to-end data operations for your SurveySparrow API with Nexla. Our bi-directional SurveySparrow connector is purpose-built for SurveySparrow, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to SurveySparrow or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your SurveySparrow workflows fast, secure, and fully governed.

Features

Type: API

SourceDestination

• Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
• Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
• API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
• Request optimization with intelligent batching, retry, and caching to minimize API calls and costs

Prerequisites

Before creating a SurveySparrow credential, you need an OAuth 2.0 Client ID and Client Secret from a private app in your SurveySparrow account. Nexla uses these client credentials to obtain an access token from the SurveySparrow OAuth token endpoint, and that token is sent as a Bearer token in the Authorization header of every API request.

To obtain your credentials:

1. Sign in to your SurveySparrow account with an account that has administrator permissions.

2. Go to Settings and open the Apps & Integrations section.

3. Create a Private App, entering a name and description and selecting the API scopes your integration requires.

4. Save the app, then copy the generated Client ID and Client Secret. Store them securely, as the secret may be shown only once and would otherwise need to be regenerated.

SurveySparrow provides region-specific API hosts. This connector is configured for the primary api.surveysparrow.com host; confirm your account's data region matches before creating the credential. For full details on private apps, OAuth, and available endpoints, see the SurveySparrow API documentation.

Authenticate

Credentials required

Field	Required	Secret	Description
Client ID	Yes	No	A unique public identifier assigned to your application
Client Secret	Yes	Yes	A confidential password provided alongside the client ID

Create a credential in Nexla

1. After selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

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

3. Enter your SurveySparrow Client ID in the corresponding field.

4. Enter your SurveySparrow Client Secret in the corresponding field. This value is confidential and should be kept secure.

   Nexla exchanges these client credentials for an access token automatically. If your Client Secret is ever exposed, regenerate it from your SurveySparrow private app settings and update the credential in Nexla.

   For detailed information about authentication, OAuth, and available endpoints, see the SurveySparrow API documentation.

5. Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation.

Use as a data source

To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the SurveySparrow connector tile, then select the credential that will be used to connect to SurveySparrow, and click Next; or, create a new SurveySparrow credential for use in this flow.

Endpoint templates

Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common SurveySparrow endpoints. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below.

[Rest API] Get all surveys

Retrieves all surveys in your SurveySparrow account. Use this template when you need a full list of surveys for reporting, inventory, or as the starting point for fetching related survey data.

For detailed information about survey objects and response fields, see the SurveySparrow API documentation.

[Rest API] Get a survey

Retrieves a single survey by its identifier. Provide the survey Id in the endpoint parameter to fetch the details of one specific survey.

For detailed information about survey objects and response fields, see the SurveySparrow API documentation.

[Rest API] Get all survey folders

Retrieves all survey folders in your account. Use this template to list the folders that organize your surveys.

For detailed information about survey folder objects and response fields, see the SurveySparrow API documentation.

[Rest API] Get a survey folder

Retrieves a single survey folder by its identifier. Provide the folder Id in the endpoint parameter to fetch the details of one specific folder.

For detailed information about survey folder objects and response fields, see the SurveySparrow API documentation.

[Rest API] Get a question

Retrieves a single survey question by its identifier. Provide the question Id in the endpoint parameter to fetch the details of one specific question.

For detailed information about question objects and response fields, see the SurveySparrow API documentation.

[Rest API] Get response properties

Retrieves the available response properties, which describe the metadata fields attached to survey responses. Use this template to understand the structure of response data before ingesting responses.

For detailed information about response properties and response fields, see the SurveySparrow API documentation.

[Rest API] Get all responses

Retrieves all survey responses in your account. Use this template to ingest response data for analytics, reporting, or downstream storage.

For detailed information about response objects and response fields, see the SurveySparrow API documentation.

[Rest API] Get a response

Retrieves a single survey response by its identifier. Provide the response Id in the endpoint parameter to fetch the details of one specific response.

For detailed information about response objects and response fields, see the SurveySparrow API documentation.

[Rest API] Batch response creation status

Retrieves the status of a batch response creation job. Provide the batch Token in the endpoint parameter to check whether a previously submitted batch of responses has finished processing.

For detailed information about batch response processing, see the SurveySparrow API documentation.

[Rest API] Get all contacts

Retrieves all contacts in your SurveySparrow account. Use this template to ingest the contact records used as survey recipients.

For detailed information about contact objects and response fields, see the SurveySparrow API documentation.

[Rest API] Get a contact

Retrieves a single contact by its identifier. Provide the contact Id in the endpoint parameter to fetch the details of one specific contact.

For detailed information about contact objects and response fields, see the SurveySparrow API documentation.

Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.

Manual configuration

SurveySparrow data sources can also be manually configured to ingest data from any valid SurveySparrow REST API endpoint, including endpoints not covered by the pre-built templates, chained API calls, or custom request parameters. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers.

Once all of the relevant settings have been configured, click the Create button in the upper right corner of the screen to save and create the new SurveySparrow data source. Nexla will now begin ingesting data from the configured endpoint and will organize any data that it finds into one or more Nexsets.

Use as a destination

Click the + icon on the Nexset that will be sent to the SurveySparrow destination, and select the Send to Destination option from the menu. Select the SurveySparrow connector from the list of available destination connectors, then select the credential that will be used to connect to SurveySparrow, and click Next; or, create a new SurveySparrow credential for use in this flow.

Endpoint templates

Nexla provides pre-built templates that can be used to rapidly configure destinations to send data to common SurveySparrow endpoints. Select the endpoint to which data will be sent from the Endpoint pulldown menu. Then, click on the template in the list below to expand it, and follow the instructions to configure additional endpoint settings.

[Rest API] Create a survey

Creates a new survey from records in a Nexset. Each record is sent as a JSON request body to create a survey in your SurveySparrow account.

The request body must match the format the SurveySparrow API expects. For details on survey creation and required fields, see the SurveySparrow API documentation.

[Rest API] Update a survey

Updates an existing survey. Provide the survey Id in the endpoint parameter; each record is sent as a JSON request body containing the fields to update.

The request body must match the format the SurveySparrow API expects. For details on survey updates and required fields, see the SurveySparrow API documentation.

[Rest API] Clone a survey

Creates a copy of an existing survey. Provide the survey Id in the endpoint parameter to clone that survey into a new one.

For details on cloning surveys and any accepted body parameters, see the SurveySparrow API documentation.

[Rest API] Create survey section

Creates a new section within a survey from records in a Nexset. Each record is sent as a JSON request body describing the section to create.

The request body must match the format the SurveySparrow API expects. For details on survey sections, see the SurveySparrow API documentation.

[Rest API] Update survey section

Updates an existing survey section. Provide the section Id in the endpoint parameter; each record is sent as a JSON request body with the fields to update.

The request body must match the format the SurveySparrow API expects. For details on survey sections, see the SurveySparrow API documentation.

[Rest API] Delete a section

Deletes a survey section. Provide the section Id in the endpoint parameter to remove that section.

Deletion is permanent. For details on deleting survey sections, see the SurveySparrow API documentation.

[Rest API] Create a survey folder

Creates a new survey folder from records in a Nexset. Each record is sent as a JSON request body describing the folder to create.

For details on survey folders, see the SurveySparrow API documentation.

[Rest API] Delete a survey folder

Deletes a survey folder. Provide the folder Id in the endpoint parameter to remove that folder.

Deletion is permanent. For details on deleting survey folders, see the SurveySparrow API documentation.

[Rest API] Update a question

Updates an existing survey question. Provide the question Id in the endpoint parameter; each record is sent as a JSON request body with the fields to update.

The request body must match the format the SurveySparrow API expects. For details on questions, see the SurveySparrow API documentation.

[Rest API] Delete a question

Deletes a survey question. Provide the question Id in the endpoint parameter to remove that question.

Deletion is permanent. For details on deleting questions, see the SurveySparrow API documentation.

[Rest API] Create a response

Creates a new survey response from records in a Nexset. Each record is sent as a JSON request body describing the response to create.

The request body must match the format the SurveySparrow API expects. For details on responses, see the SurveySparrow API documentation.

[Rest API] Update a response

Updates an existing survey response. Provide the response Id in the endpoint parameter; each record is sent as a JSON request body with the fields to update.

The request body must match the format the SurveySparrow API expects. For details on responses, see the SurveySparrow API documentation.

[Rest API] Delete a response

Deletes a survey response. Provide the response Id in the endpoint parameter to remove that response.

Deletion is permanent. For details on deleting responses, see the SurveySparrow API documentation.

[Rest API] Batch create responses

Submits multiple survey responses in a single batch request. Use this template to create many responses at once from a Nexset.

Batch creation runs asynchronously; use the Batch response creation status source endpoint to check when processing completes. For details, see the SurveySparrow API documentation.

[Rest API] Start a new response (partial submission)

Starts a new response as a partial submission, allowing answers to be added incrementally. Each record is sent as a JSON request body to begin a response.

Use this together with Add answers for a response and Complete a response to build a response in stages. For details, see the SurveySparrow API documentation.

[Rest API] Complete a response

Marks a partial response as complete. Provide the response Id in the endpoint parameter to finalize a response that was started earlier.

For details on partial submissions and completing responses, see the SurveySparrow API documentation.

[Rest API] Add answers for a response

Adds answers to an in-progress response. Provide the response Id in the endpoint parameter; each record is sent as a JSON request body with the answers to add.

Use this together with Start a new response (partial submission) and Complete a response. For details, see the SurveySparrow API documentation.

Manual configuration

SurveySparrow destinations can also be manually configured to send data to any valid SurveySparrow REST API endpoint. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, data format, endpoint URL, request headers, attribute exclusions, record batching, and response webhooks.

SurveySparrow APIs expect JSON format for most operations. For update or delete operations, include the identifier of the object at the end of the URL.

Save & activate

Once all endpoint settings have been configured, click the Done button in the upper right corner of the screen to save and create the destination. To send the data to the configured SurveySparrow endpoint, open the destination resource menu, and select Activate.

The Nexset data will not be sent to the SurveySparrow endpoint until the destination is activated. Destinations can be activated immediately or at a later time, providing full control over data movement.