Survicate

The Survicate modules allow you to watch, and list surveys in your Survicate account.

Getting Started with Survicate

Prerequisites

  • A Survicate account

In order to use Survicate with Make, it is necessary to have a Survicate account. If you do not have one, you can create a Survicate account at panel.survicate.com/#/signup.

Note

The module dialog fields that are displayed in bold (in the Make scenario, not in this documentation article) are mandatory!

To connect your Survicate account to Make you need to obtain the API Key from your Survicate account and insert it in the Create a connection dialog in the Make module.

1. Log in to your Survicate account.

2. Click Settings (61f27bb6e18ad.png) > Integrations > Data Export API.

61f27bb7e06be.gif

3. Copy the API Key to your clipboard.

61f27bba3528e.png

4. Go to Make and open the Survicate module's Create a connection dialog.

61f27bbb498db.gif

5. In the Connection name field, enter a name for the connection.

6. In the API Key field, enter the API key copied in step 3 and click Continue.

The connection has been established.

Watch Answers Data

Triggers when a user answers a question.

Webhook Name

Enter a name for the webhook.

Connection

Establish a connection to your Survicate account.

See Connecting to Survicate Webhook using Make to add the webhook in your Survicate account.

Watch Survey Completions

Triggers when a respondent completes the survey.

Webhook Name

Enter a name for the webhook.

Connection

Establish a connection to your Survicate account.

See Connecting to Survicate Webhook using Make to add the webhook in your Survicate account.

Get a Single Survey Data

Returns single survey data by the indicator.

Connection

Establish a connection to your Survicate account.

Survey ID

Select the Survey ID whose details you want to retrieve.

Make an API Call

Performs an arbitrary authorized API call.

Connection

Establish a connection to your Survicate account.

URL

Enter a path relative to https://data-api.survicate.com/. For example: /v1/surveys

Note

For the list of available endpoints, refer to the Survicate API Documentation.

Method

Select the HTTP method you want to use:

GET to retrieve information for an entry.

POST to create a new entry.

PUT to update/replace an existing entry.

PATCH to make a partial entry update.

DELETE to delete an entry.

Headers

Enter the desired request headers. You don't have to add authorization headers; we already did that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

Example of Use - List Surveys

The following API call returns all the surveys from your Survicate account:

URL: /v1/surveys

Method: GET

61f27bbd5f4b6.png

Matches of the search can be found in the module's Output under Bundle > Body. In our example, 7 surveys were returned:

61f27bbe6c7ea.png

List Survey

Returns a list of all surveys.

Connection

Establish a connection to your Survicate account.

Limit

Set the maximum number of surveys Make should return during one scenario execution cycle.

List Survey Responses

Returns an array of questions and their answers, along with attributes of respondents.

Connection

Establish a connection to your Survicate account.

Survey ID

Select the Survey ID whose responses you want to list.

Limit

Set the maximum number of survey responses Make should return during one scenario execution cycle.

You need a Survicate Upgraded account to enable and use the webhooks.

1. Open any Watch module, enter the details as mentioned in the respective module description, and copy the address to your clipboard.

61f27bbf82864.gif

2. Click Settings > Integrations > Enable the Webhook.

61f27bc1cf160.gif

3. Click the Edit Icon (61f27bc438ec2.png) on the survey for which you want to enable the webhook > Settings > Webhooks.

61f27bc53d77c.gif

4. Enable the responses for which you want to receive the triggers by entering the URL address copied in step 1 and click Save.

61f27bc7ec4b7.png

You have successfully added the webhooks.