# Typeform

{% @arcade/embed flowId="OrlUZRQVqTJH448Xnv9f" url="<https://app.arcade.software/share/OrlUZRQVqTJH448Xnv9f>" %}

To use Typeform in StackAI, connect your Typeform account using a valid connection ID. Once connected, you can trigger actions such as retrieving forms, collecting responses, or managing form data. Each action requires specific inputs and configurations, which you provide in the workflow builder.

**Establishing A Connection**

1. Click **“New Connection”** and enter a name to identify it later.
2. You’ll be redirected to the Typeform login page.
3. Log in to your Typeform account.
4. Accept the required permissions. You’ll be redirected back to StackAI.
5. In the dropdown, select your newly created connection.
6. Click **“Test”** to verify that the connection is healthy.

**Action Summary Table**

<table><thead><tr><th width="261.8046875">Action Name</th><th>Description</th><th>Input</th></tr></thead><tbody><tr><td>retrieve_account_workspaces</td><td>Retrieve all workspaces in your Typeform account</td><td>Account Id, Search, Page, Page Size</td></tr><tr><td>retrieve_forms</td><td>Retrieve all forms in your Typeform account</td><td>Search, Page, Page Size, Workspace Id</td></tr><tr><td>delete_form</td><td>Delete a specific form</td><td>Form Id</td></tr><tr><td>retrieve_form</td><td>Retrieve a single form's details</td><td>Form Id</td></tr><tr><td>update_form_patch</td><td>Update a form (partial update)</td><td>Form Id</td></tr><tr><td>update_form</td><td>Update a form (full update)</td><td>Form Id</td></tr><tr><td>retrieve_custom_form_messages</td><td>Retrieve custom messages for a form</td><td>Form Id</td></tr><tr><td>update_custom_messages</td><td>Update custom messages for a form</td><td>Form Id</td></tr><tr><td>delete_responses</td><td>Delete responses from a form</td><td>Form Id, Included Response Ids</td></tr><tr><td>retrieve_responses</td><td>Retrieve responses for a form</td><td>Form Id, Page Size, Since, Until, After, Before, Included Response Ids, Excluded Response Ids, Completed, Sort, Query, Fields, Answered Fields</td></tr><tr><td>retrieve_response_file</td><td>Download all responses for a form as a file</td><td>Form Id, Response Id, Field Id, Filename, Inline</td></tr><tr><td>retrieve_webhooks</td><td>Retrieve all webhooks for a form</td><td>Form Id</td></tr><tr><td>delete_webhook</td><td>Delete a webhook from a form</td><td>Form Id, Tag</td></tr><tr><td>retrieve_single_webhook</td><td>Retrieve a single webhook's details</td><td>Form Id, Tag</td></tr><tr><td>retrieve_images_collection</td><td>Retrieve all images in your Typeform account</td><td>-</td></tr><tr><td>delete_image</td><td>Delete an image from your Typeform account</td><td>Image Id</td></tr><tr><td>retrieve_image</td><td>Retrieve a single image's details</td><td>Image Id</td></tr><tr><td>retrieve_background_by_size</td><td>Retrieve a background image by size</td><td>Image Id, Size</td></tr><tr><td>retrieve_choice_image_by_size</td><td>Retrieve a choice image by size</td><td>Image Id, Size</td></tr><tr><td>retrieve_image_by_size</td><td>Retrieve an image by size</td><td>Image Id, Size</td></tr><tr><td>retrieve_form_insights</td><td>Retrieve insights for a form</td><td>Form Id</td></tr><tr><td>retrieve_your_own_user</td><td>Retrieve your own user details</td><td>-</td></tr><tr><td>rtbf_delete_responses</td><td>Delete responses for right to be forgotten (GDPR)</td><td>Account Id</td></tr><tr><td>retrieve_themes</td><td>Retrieve all themes in your Typeform account</td><td>Page, Page Size</td></tr><tr><td>delete_theme</td><td>Delete a theme from your Typeform account</td><td>Theme Id</td></tr><tr><td>retrieve_theme</td><td>Retrieve a single theme's details</td><td>Theme Id</td></tr><tr><td>update_theme</td><td>Update a theme</td><td>Theme Id</td></tr><tr><td>retrieve_workspaces</td><td>Retrieve all workspaces</td><td>Search, Page, Page Size</td></tr><tr><td>delete_workspace</td><td>Delete a workspace</td><td>Workspace Id</td></tr><tr><td>retrieve_workspace</td><td>Retrieve a single workspace's details</td><td>Workspace Id</td></tr><tr><td>update_workspace</td><td>Update a workspace</td><td>Workspace Id</td></tr></tbody></table>

**Output**

1. Status Code (integer)
   * This is the HTTP status code returned by the Typeform API after attempting to delete the form.
   * Common values:
     * 200: Success (form deleted)
     * 204: Success (no content, form deleted)
     * 404: Not found (form does not exist)
     * 401/403: Unauthorized/Forbidden (invalid credentials or permissions)
     * 500: Internal server error
2. Headers (dict)
   * This is a dictionary containing the HTTP response headers from the Typeform API.
   * Headers may include metadata such as:
     * Content-Type: The format of the response (e.g., application/json)
     * Date: The time the response was sent
     * Rate limit information: How many API calls you have left, etc.
3. Body (object)
   * This is the main content of the response, usually in JSON format.
   * For a successful delete, the body may be empty or contain a confirmation message.
   * For errors, the body will typically include details such as:
     * error: A short error code or message
     * description: A human-readable explanation of the error

**Advanced Settings**

* Retry on Failure: Enable retrying when the node execution fails
* Fallback Branch: Create a separate branch that executes when this node fails, allowing you to handle errors gracefullyCreate a separate branch that executes when this node fails, allowing you to handle errors gracefully