Active
This application does not need additional settings. So you can make connection only by using your login credentials or by following the instructions below .

Typeform

Getting Started with Typeform

The Typeform modules allow you to monitor and retrieve submitted responses and response files, or to create, retrieve, and delete forms and webhooks in your Typeform account.

Prerequisites

  • A Typeform account

In order to use Typeform with Boost.space Integrator, it is necessary to have a Typeform account. If you do not have one, you can create a Typeform account at admin.typeform.com/signup.

[Caution] Caution
The module dialog fields that are displayed in bold (in the Boost.space Integrator scenario, not in this documentation article) are mandatory!

Connecting Typeform to Boost.space Integrator

To connect your Typeform account to Boost.space Integrator follow the general instructions for Connecting to services.

After you click the Continue button, Boost.space Integrator will redirect you to the Typeform website where you will be prompted to grant Boost.space Integrator access to your account.

61d6b995a6125.png

Confirm the dialog by clicking the Accept button.

Responses

You may need to extend your permissions. To do so, click the Continue button and then the Accept button.

61d6b996b1ef1.png

Get a Response File

Retrieves a file uploaded by the form submitter as a response to the answer.

Required Permissions: forms:read, responses:read


Connection
Establish a connection to your Typeform account.

Response ID
Enter (map) the ID of the response you want to retrieve the file from. You can map it from the previous modules, e.g. Watch Responses (not the webhook!) or List forms module.

URL/IDs
Select whether you want to enter (map) the URL or enter IDs manually.

You can map the file URL from the previous module. Select the answer that contains the file from the returned Mappable answers collection (e.g. from the Watch Responses, or List Responses module).

61d6b997b30f6.png

Mapped fields:

List Responses

Returns all responses from a specified form by the selected filter settings.

Required Permissions: forms:read, responses:read


Connection
Establish a connection to your Typeform account.

Limit
Enter the maximum number of responses Boost.space Integrator will return during one execution.

Form ID
Select or map (Form ID) the form you want the returned responses for.

Fields
Add fields (select from the menu or map the Field ID) you want to filter the results by. Only responses that contain the specified fields will be returned.

Completed
Select the Yes option to return only forms that were submitted.

Query
Enter the text string to return only responses that contain the entered text.

Since
Enter the date and time to filter the results to responses submitted since the specified date and time. The list of supported date and time formats.

Until
Enter the date and time to filter the results to responses submitted until the specified date and time. The list of supported date and time formats.

Watch Responses

Returns response details when the specified form is submitted.

Required Permissions: forms:read, responses:read


Connection
Establish a connection to your Typeform account.

Limit
Enter the maximum number of responses Boost.space Integrator will return during one execution.

Form ID
Select or map (Form ID) the form you want the returned responses for.

Fields
Add fields (select from the menu or map the Field ID) you want to filter the results by. Only responses that contain the specified fields will be returned.

Completed
Select the Yes option to return only forms that were submitted.

Query
Enter the text string to return only responses that contain the entered text.

Watch Responses (Instant Trigger)

Triggers immediately when the form is submitted.

Required Permissions: forms:read, responses:write


Webhook name
Enter the name of the webhook, e.g. Customer survey submitted.

Connection
Establish a connection to your Typeform account.

Form ID
Select the form you want to receive responses for.

Enabled
Enable this option to send the form responses from Typeform to Boost.space Integrator immediately.

Forms

Create a Form

Allows you to create a form.

Required Permissions: forms:read, forms:write


Connection
Establish a connection to your Typeform account.

Title
Enter the form’s name.

Language
Select the language you want to use for the form.

Is public
Select the Yes option to set the form as publicly available.

Progress bar
Select whether to show percentage or proportion as the progress bar (in the bottom-right corner of the form).

Show progress bar
Select the Yes option to show the progress bar in the form.

Show typeform branding
Select the No option to hide the Typeform branding (“Powered by Typeform”). Hiding the branding is available only for PRO+ accounts.

Allow indexing
Enable this option to allow search engines to index your Typeform and show the URL in the search results.

Description
Enter the description that will be displayed under the name when shared on social media or showed as a search result.

Image URL
Enter the description that will be displayed under the name when shared on social media or showed as a search result.

URL
Enter the URL where the user will be redirected after the form submission.

Google Analytics tracking ID
Enter the Google Analytics tracking ID to the form to get the data you need to measure campaigns, improve conversions, and more.

Facebook pixel tracking ID
Enter your Facebook pixel ID and get all the data you need to measure and optimize your marketing campaigns.

Google Manager ID
Add your own code snippets to Typeforms for conversion tracking, site analytics, retargeting, and more.

Notifications – Self
Enable this option to be notified when a user submits the Typeform.

Notifications – Respondent
Enable this option to send the notification to the respondent when he or she submits the Typeform.

Theme URL
Enter the URL of the theme to be used for the Typeform. If you don’t specify a URL for the theme, Typeform applies a new copy of the default theme to the form.

Workspace URL
Enter the URL of the workspace to be used for the Typeform. If you don’t specify a URL for the workspace, Typeform saves the form in the default workspace.

Hidden
Use this field to add hidden fields to the form.

Variables – Score
Recall information for keeping score as the users answer each question (for example for quizzes).

Variables – Price
Enter the price (number). Recall information for tracking the total price of all the items the users select (for example for shopping carts, donation campaigns, and payment collections).

Welcome screen
Add and set up the welcome screen for your form.

  • Title: Enter the title of the form that will be displayed on the welcome screen.
  • Description: Enter a short description that will be displayed under the title.
  • Show button: Enable this option to display the Start button on the welcome screen.
  • Text to display: Enter the text that will be displayed on the start button.
  • Attachment: Enter the URL to the image or video that will be displayed on the welcome screen.

Thank you screen
Add and set up the Thank you screen for your form.

Please see the descriptions of the fields in the Welcome screen section above.

  • Redirect URL: Enter the URL where the respondent will be redirected after clicking the Submit button.
  • Share icons: Enable this option to display social media sharing icons on the Thank you screen so respondents can post your Typeform’s link on Facebook, Twitter, LinkedIn, and Google+.

Fields
Add fields (questions) to your form, select the type of the field and specify its properties, validations, and attachments.

Logic
Add and specify Logic Jump objects to be used in the form.

Get a Form

Retrieves form details.

Required Permissions: forms:read


Connection
Establish a connection to your Typeform account.

ID
Enter (map) the ID of the form you want to retrieve details about.
61d6b998b41ee.png

Update a Form

Updates an existing form.

Any fields you don’t include in the module will be deleted from your form.

Required Permissions: forms:read, forms:write


Connection
Establish a connection to your Typeform account.

Form ID
Enter (map) the ID of the form you want to update.


Please find the descriptions of the fields in the Create a Form section above.

Delete a Form

Deletes a specified form and all of the form’s responses.

Required Permissions: forms:read, forms:write


Connection
Establish a connection to your Typeform account.

ID
Enter (map) the ID of the form you want to delete.

List Forms

Returns all forms by a specified filter.

Required Permissions: forms:read, workspaces:read


Connection
Establish a connection to your Typeform account.

Limit
Enter the maximum number of forms Boost.space Integrator will return during one execution cycle.

Workspace ID
Select or map the workspace you want to list forms from.

Search filter
Enter the search term. Forms that contain the entered text will be returned.

Webhooks

Create/Update a Webhook

Creates or updates a webhook.

Required Permissions: forms:read, webhooks:write


Connection
Establish a connection to your Typeform account.

Form ID
Select or map (Form ID) the form you want to create the webhook for.

Webhook name
Enter the name of the webhook.

Webhook URL
Enter the webhook URL of the webhook you want to update.

Delete a Webhook

Deletes a webhook.

Required Permissions: forms:read, webhooks:write

[Warning] Warning
If you delete a webhook, it cannot be undone. Typeform submissions won’t get delivered after the webhook deletion.

Connection
Establish a connection to your Typeform account.

Form ID
Select or map (Form ID) the form you want to delete the webhook from.

Webhook name
Enter the unique name of the webhook you want to delete.

Images

Create an Image

Adds an Image to your account.


Connection
Establish a connection to your Typeform account.

Data / URL
Specify whether you want to provide image data or image URL.

Source file
Map the file you want to upload from the previous module (e.g. HTTP > Get a File or Dropbox > Get a file), or enter the file name and file data manually.

URL
  • Filename: Enter the file name for the file you want to upload.
  • Image URL: Enter the image URL.

Delete an Image

Deletes an image from your Typeform account.


Connection
Establish a connection to your Typeform account.

ID
Enter (map) the ID of the image you want to delete from your Typeform account.

List Images

Retrieves details of all images in your account.


Connection
Establish a connection to your Typeform account.

Limit
Set the maximum number of images Boost.space Integrator will return during one execution cycle.

Other

Make an API Call

Allows you to perform a custom API call.


Connection
Establish a connection to your Typeform account.

URL
Enter a path relative to https://api.typeform.com, e.g. /forms.

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


Method
Select the HTTP method you want to use:

  • GETto retrieve information for an entry.
  • POSTto create a new entry.
  • PUTto update/replace an existing entry.
  • PATCHto 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 Forms

The following API call returns forms in your Typeform account:


URL:

/forms


Method:

GET


Query String:

Key: page_size

Value: 25

61d6b999a0e34.png

Matches of the search can be found in the module’s Output under Bundle > Body > items.

In our example, 2 forms were returned:

61d6b99a9b3b5.png