# Typeform

Your Toolhouse AI Worker can connect to Typeform using 35 specialized tools.

## Auth Connection

This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under [Auth Connections](https://toolhouse.app/auth-connections?authkit_slugs=typeform).

## Tools (35)

### `Typeform Create Account Workspace`

Integration name: **TYPEFORM\_CREATE\_ACCOUNT\_WORKSPACE**

Tool to create a new workspace in a specific Typeform account. Use when you need to create a workspace within a particular account using the account ID.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type   | Required | Example                        | Description                                                                    |
| ------------ | ------ | :------: | ------------------------------ | ------------------------------------------------------------------------------ |
| `name`       | string |     ✅    | `"Marketing Team"`             | Name of the new workspace to create                                            |
| `account_id` | string |     ✅    | `"01KEBVS4Y8D96GR8E7Z6MGV20A"` | The ULID format identifier for the account where the workspace will be created |

***

### `Typeform Create Form`

Integration name: **TYPEFORM\_CREATE\_FORM**

Tool to create a new Typeform form with customizable fields, logic, and settings. Use when you need to programmatically create a form with specific questions, welcome screens, thank you screens, and conditional logic.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type   | Required | Example                      | Description                                              |
| ------------------ | ------ | :------: | ---------------------------- | -------------------------------------------------------- |
| `type`             | string |          | `"quiz"`                     | Form type (quiz, classification, score, branching, etc.) |
| `logic`            | array  |          | —                            | Conditional logic jumps and variable calculations        |
| `theme`            | object |          | —                            | Theme reference                                          |
| `title`            | string |     ✅    | `"Customer Feedback Survey"` | Form title                                               |
| `fields`           | array  |          | —                            | Array of field definitions for the form questions        |
| `settings`         | object |          | —                            | Form settings configuration                              |
| `workspace`        | object |          | —                            | Workspace reference                                      |
| `welcome_screens`  | array  |          | —                            | Introductory content screens shown before form fields    |
| `thankyou_screens` | array  |          | —                            | Completion screens shown after form submission           |

***

### `Typeform Create Image`

Integration name: **TYPEFORM\_CREATE\_IMAGE**

Tool to upload a new image to your Typeform account via base64 encoding or URL. Use when you need to add images for forms or presentations. Either 'image' (base64) or 'url' parameter must be provided.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type   | Required | Example                                                          | Description                                                                                           |
| ----------- | ------ | :------: | ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| `url`       | string |          | `"https://images.unsplash.com/photo-1506905925346-21bda4d32df4"` | Direct link to an existing image online. Either 'image' or 'url' must be provided.                    |
| `image`     | string |          | —                                                                | Base64 code for the image (exclude data:image descriptors). Either 'image' or 'url' must be provided. |
| `file_name` | string |     ✅    | `"test_image.jpg"`                                               | The name assigned to your image file                                                                  |

***

### `Typeform Create Or Update Webhook`

Integration name: **TYPEFORM\_CREATE\_OR\_UPDATE\_WEBHOOK**

Tool to create a new webhook or update an existing one for a specified Typeform. Use when you need to configure webhooks to receive form response notifications at a specified URL.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example                                  | Description                                                                                                                  |
| ------------- | ------- | :------: | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `tag`         | string  |     ✅    | `"test-webhook-tag"`                     | Unique webhook name you assign to identify this webhook                                                                      |
| `url`         | string  |     ✅    | `"https://webhook.site/unique-url-test"` | Webhook destination URL where form responses will be sent                                                                    |
| `secret`      | string  |          | —                                        | HMAC SHA256 signing key for payload verification. Use this to verify webhook authenticity                                    |
| `enabled`     | boolean |          | —                                        | Whether to send responses immediately. Set to true to enable the webhook, false to disable it                                |
| `form_id`     | string  |     ✅    | `"Y78g1cmS"`                             | Unique identifier for the form                                                                                               |
| `verify_ssl`  | boolean |          | —                                        | Whether to verify SSL certificates during webhook delivery. Set to false if using self-signed certificates                   |
| `event_types` | object  |          | —                                        | Event types that trigger the webhook (e.g., {'form\_response\_partial': True}). If not specified, defaults to form\_response |

***

### `Typeform Create Theme`

Integration name: **TYPEFORM\_CREATE\_THEME**

Tool to create a new custom theme in Typeform with colors, fonts, background, and layout settings. Use when you need to create a theme for branding and styling Typeform forms.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                | Type    | Required | Example                       | Description                                                                                                          |
| ------------------------ | ------- | :------: | ----------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| `font`                   | string  |     ✅    | `"Karla"`                     | Font choice from predefined Typeform options (e.g., 'Karla', 'Arial', 'Georgia'). This field is required by the API. |
| `name`                   | string  |          | `"Test Theme Created by API"` | Name of the theme                                                                                                    |
| `colors`                 | object  |     ✅    | —                             | Color configuration with answer, background, button, and question hex values. All color fields are required.         |
| `fields`                 | object  |     ✅    | —                             | Field alignment (left/center) and font\_size (small/medium/large). Both fields are required.                         |
| `background`             | object  |          | —                             | Background configuration for the theme.                                                                              |
| `rounded_corners`        | string  |          | `"small"`                     | Border radius setting. Must be 'none', 'small', or 'large'                                                           |
| `has_transparent_button` | boolean |          | `false`                       | Whether the button should be transparent                                                                             |

***

### `Typeform Create Workspace`

Integration name: **TYPEFORM\_CREATE\_WORKSPACE**

Tool to create a new workspace in Typeform. Use when organizing forms into separate workspaces for teams or projects.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example            | Description                         |
| --------- | ------ | :------: | ------------------ | ----------------------------------- |
| `name`    | string |     ✅    | `"Marketing Team"` | The name of the workspace to create |

***

### `Typeform Delete Form`

Integration name: **TYPEFORM\_DELETE\_FORM**

Tool to permanently delete a Typeform and all of its responses. Use when you need to remove a form completely from the account.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example      | Description                                  |
| --------- | ------ | :------: | ------------ | -------------------------------------------- |
| `form_id` | string |     ✅    | `"Eu7aUntt"` | Unique form identifier found in the form URL |

***

### `Typeform Delete Image`

Integration name: **TYPEFORM\_DELETE\_IMAGE**

Tool to delete an image from your Typeform account. Use when you need to remove an image that is no longer needed. Returns a success status once the image has been deleted (204 No Content).

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter  | Type   | Required | Example          | Description                                   |
| ---------- | ------ | :------: | ---------------- | --------------------------------------------- |
| `image_id` | string |     ✅    | `"zMTupVAd3fzt"` | The unique identifier for the image to remove |

***

### `Typeform Delete Responses`

Integration name: **TYPEFORM\_DELETE\_RESPONSES**

Tool to delete specific responses from a Typeform by response IDs. Use when you need to remove response data from a form. Deletion is asynchronous - a 200 status means the deletion request was registered, not that deletion is complete. Maximum 1000 response IDs can be deleted per request.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter               | Type   | Required | Example                  | Description                                                                           |
| ----------------------- | ------ | :------: | ------------------------ | ------------------------------------------------------------------------------------- |
| `form_id`               | string |     ✅    | `"CoZt0LNp"`             | Unique form identifier                                                                |
| `included_response_ids` | string |     ✅    | `"test_response_id_123"` | Comma-separated list of response IDs to delete (max 1000 IDs). Example: 'id1,id2,id3' |

***

### `Typeform Delete Theme`

Integration name: **TYPEFORM\_DELETE\_THEME**

Tool to delete a theme from your Typeform account. Use when you need to permanently remove a theme. This operation cannot be undone.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter  | Type   | Required | Example      | Description                       |
| ---------- | ------ | :------: | ------------ | --------------------------------- |
| `theme_id` | string |     ✅    | `"mQHasBnn"` | Unique theme identifier to delete |

***

### `Typeform Delete Webhook`

Integration name: **TYPEFORM\_DELETE\_WEBHOOK**

Tool to delete a webhook configuration from a Typeform form. Use when you need to remove a webhook from a specific form. The operation returns 204 No Content on success and 404 if the webhook is not found.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                 | Description                   |
| --------- | ------ | :------: | ----------------------- | ----------------------------- |
| `tag`     | string |     ✅    | `"test_webhook_delete"` | Unique webhook name to delete |
| `form_id` | string |     ✅    | `"CoZt0LNp"`            | Unique form identifier        |

***

### `Typeform Delete Workspace`

Integration name: **TYPEFORM\_DELETE\_WORKSPACE**

Tool to delete a workspace from your Typeform account. Use when you need to remove a workspace. Note: The default 'My Workspace' cannot be deleted, and workspaces containing forms cannot be deleted (will return an error).

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type   | Required | Example    | Description                                                                                                                     |
| -------------- | ------ | :------: | ---------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `workspace_id` | string |     ✅    | `"ucdZbu"` | Unique workspace identifier. Note: Default 'My Workspace' cannot be deleted, and workspaces containing forms cannot be deleted. |

***

### `Typeform Get About Me`

Integration name: **TYPEFORM\_GET\_ABOUT\_ME**

Get information about the owner account in Typeform.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.*

***

### `Typeform Get All Response Files`

Integration name: **TYPEFORM\_GET\_ALL\_RESPONSE\_FILES**

Tool to retrieve a compressed archive containing all files that respondents uploaded for a specified form. Use when you need to download all file uploads from a Typeform form as a ZIP archive.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example      | Description                                                  |
| --------- | ------ | :------: | ------------ | ------------------------------------------------------------ |
| `form_id` | string |     ✅    | `"CoZt0LNp"` | Unique identifier of the form to download response files for |

***

### `Typeform Get Background By Size`

Integration name: **TYPEFORM\_GET\_BACKGROUND\_BY\_SIZE**

Tool to retrieve a background image by size from Typeform. Use when you need to get a background image in a specific size (default, tablet, mobile, or thumbnail). Images are scaled and cropped from top-left alignment to fill the screen properly.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter  | Type   | Required | Example          | Description                                                                                                                                                                        |
| ---------- | ------ | :------: | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `size`     | string |     ✅    | `"default"`      | Dimension preset for the background image. default: scaled to fit 1680x1050px, tablet: scaled to fit 1024x768px, mobile: scaled to fit 460x320px, thumbnail: scaled to fit 80x50px |
| `image_id` | string |     ✅    | `"YY93X8ZdXCC3"` | Unique identifier for the image resource                                                                                                                                           |

***

### `Typeform Get Choice Image By Size`

Integration name: **TYPEFORM\_GET\_CHOICE\_IMAGE\_BY\_SIZE**

Tool to retrieve a choice image by size from Typeform. Use when you need to download images used in picture\_choice question options at specific sizes.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter  | Type   | Required | Example          | Description                                                                                                                                                                                                                |
| ---------- | ------ | :------: | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `size`     | string |     ✅    | `"default"`      | Image size to retrieve. Options: 'default' (scaled to fit 230x230px), 'thumbnail' (cropped to 80x80px), 'supersize' (cropped to 310x233px), 'supermobile' (cropped to 238x164px), 'supersizefit' (scaled to fit 310x233px) |
| `image_id` | string |     ✅    | `"YY93X8ZdXCC3"` | Unique ID for the image to retrieve                                                                                                                                                                                        |

***

### `Typeform Get Form`

Integration name: **TYPEFORM\_GET\_FORM**

Tool to retrieve a specific form's complete configuration including fields, logic, settings, and theme. Use when you need to get detailed information about a Typeform form.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example      | Description                                  |
| --------- | ------ | :------: | ------------ | -------------------------------------------- |
| `form_id` | string |     ✅    | `"CoZt0LNp"` | Unique form identifier found in the form URL |

***

### `Typeform Get Form Messages`

Integration name: **TYPEFORM\_GET\_FORM\_MESSAGES**

Tool to retrieve custom messages for a Typeform including button labels, error messages, and UI text. Use when you need to get the current message configuration for a form.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example      | Description                                  |
| --------- | ------ | :------: | ------------ | -------------------------------------------- |
| `form_id` | string |     ✅    | `"CoZt0LNp"` | Unique form identifier found in the form URL |

***

### `Typeform Get Form Responses`

Integration name: **TYPEFORM\_GET\_FORM\_RESPONSES**

Tool to retrieve form responses from Typeform with filtering by date, pagination, search, and response type. Use when you need to get responses for a specific form including timestamps of when users landed on and submitted the form. Note: Recent responses may take up to 30 minutes to appear.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter               | Type    | Required | Example      | Description                                                                                    |
| ----------------------- | ------- | :------: | ------------ | ---------------------------------------------------------------------------------------------- |
| `sort`                  | string  |          | —            | Sort format: {fieldID},{asc\|desc}. Example: 'field\_123,asc'                                  |
| `after`                 | string  |          | —            | Pagination token for responses after this point                                                |
| `query`                 | string  |          | —            | Search string matched against all response fields                                              |
| `since`                 | string  |          | —            | Filter responses from timestamp (ISO 8601 format like '2023-01-01T00:00:00Z' or Unix seconds)  |
| `until`                 | string  |          | —            | Filter responses until timestamp (ISO 8601 format like '2023-12-31T23:59:59Z' or Unix seconds) |
| `before`                | string  |          | —            | Pagination token for responses before this point                                               |
| `fields`                | array   |          | —            | Limit displayed fields in answers section. Provide field IDs.                                  |
| `form_id`               | string  |     ✅    | `"Y78g1cmS"` | Unique form identifier                                                                         |
| `page_size`             | integer |          | —            | Maximum responses per request (default: 25, max: 1000)                                         |
| `response_type`         | array   |          | —            | Filter by type: 'started', 'partial', or 'completed'. Can specify multiple values.             |
| `answered_fields`       | array   |          | —            | Filter responses containing specified field IDs                                                |
| `excluded_response_ids` | string  |          | —            | Comma-separated response IDs to exclude                                                        |
| `included_response_ids` | string  |          | —            | Comma-separated response IDs to include                                                        |

***

### `Typeform Get Image By Size`

Integration name: **TYPEFORM\_GET\_IMAGE\_BY\_SIZE**

Tool to retrieve an image in a specific size from Typeform. Use when you need to get a Typeform image optimized for different display contexts (default for desktop, mobile for mobile devices, or thumbnail for previews).

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter  | Type   | Required | Example          | Description                                                                                                               |
| ---------- | ------ | :------: | ---------------- | ------------------------------------------------------------------------------------------------------------------------- |
| `size`     | string |     ✅    | `"default"`      | The desired image dimension. Options: 'default' (800px width), 'mobile' (460px width), or 'thumbnail' (80px×50px cropped) |
| `image_id` | string |     ✅    | `"YY93X8ZdXCC3"` | Unique identifier for the image to retrieve                                                                               |

***

### `Typeform Get Theme`

Integration name: **TYPEFORM\_GET\_THEME**

Tool to retrieve a specific theme's configuration including colors, fonts, and layout settings. Use when you need to get the design settings of a Typeform theme.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter  | Type   | Required | Example    | Description             |
| ---------- | ------ | :------: | ---------- | ----------------------- |
| `theme_id` | string |     ✅    | `"qHWOQ7"` | Unique ID for the theme |

***

### `Typeform Get Webhook`

Integration name: **TYPEFORM\_GET\_WEBHOOK**

Tool to retrieve a single webhook by specifying both the form ID and webhook tag. Use when you need to get details about a specific webhook configuration.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                   | Description                         |
| --------- | ------ | :------: | ------------------------- | ----------------------------------- |
| `tag`     | string |     ✅    | `"test_webhook_retrieve"` | Unique name assigned to the webhook |
| `form_id` | string |     ✅    | `"CoZt0LNp"`              | Unique form identifier              |

***

### `Typeform Get Workspace`

Integration name: **TYPEFORM\_GET\_WORKSPACE**

Tool to retrieve detailed information about a specific workspace including its name, forms, and team members. Use when you need to get workspace details or check member access.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type   | Required | Example    | Description                                     |
| -------------- | ------ | :------: | ---------- | ----------------------------------------------- |
| `workspace_id` | string |     ✅    | `"dZMAWB"` | Unique identifier for the workspace to retrieve |

***

### `Typeform List Forms`

Integration name: **TYPEFORM\_LIST\_FORMS**

Tool to retrieve a list of all forms in your Typeform account with filtering, pagination, and sorting options. Use when you need to list, search, or browse forms across workspaces. Supports filtering by search terms, workspace, and sorting by creation or modification date.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type    | Required | Example               | Description                                                                                                 |
| -------------- | ------- | :------: | --------------------- | ----------------------------------------------------------------------------------------------------------- |
| `page`         | integer |          | `1`                   | Page number for pagination (default: 1)                                                                     |
| `search`       | string  |          | `"customer feedback"` | Filters results containing the specified string in form titles or descriptions                              |
| `sort_by`      | string  |          | —                     | Field to sort results by: 'created\_at' for creation date or 'last\_updated\_at' for last modification date |
| `order_by`     | string  |          | —                     | Sort order: 'asc' for ascending or 'desc' for descending                                                    |
| `page_size`    | integer |          | `10`                  | Number of results per page (default: 10, maximum: 200)                                                      |
| `workspace_id` | string  |          | `"wrk_abc123"`        | Filter forms by workspace ID to retrieve forms from a specific workspace                                    |

***

### `Typeform List Images`

Integration name: **TYPEFORM\_LIST\_IMAGES**

Tool to retrieve all images in your Typeform account in reverse-chronological order. Use when you need to list or browse available images.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.*

***

### `Typeform List Themes`

Integration name: **TYPEFORM\_LIST\_THEMES**

Tool to retrieve a paginated list of themes in your Typeform account. Use when you need to access available themes for form styling. Returns both public and private themes with their styling configurations.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type    | Required | Example | Description                                           |
| ----------- | ------- | :------: | ------- | ----------------------------------------------------- |
| `page`      | integer |          | `1`     | Page number to retrieve (default: 1)                  |
| `page_size` | integer |          | `10`    | Number of results per page, maximum 200 (default: 10) |

***

### `Typeform List Webhooks`

Integration name: **TYPEFORM\_LIST\_WEBHOOKS**

Tool to retrieve all webhooks associated with a specified typeform. Use when you need to view webhook configurations for a form. Returns webhook IDs, URLs, enabled status, event types, and timestamps.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example      | Description                                           |
| --------- | ------ | :------: | ------------ | ----------------------------------------------------- |
| `form_id` | string |     ✅    | `"CoZt0LNp"` | Unique form identifier for which to retrieve webhooks |

***

### `Typeform List Workspaces`

Integration name: **TYPEFORM\_LIST\_WORKSPACES**

Tool to retrieve all workspaces in a Typeform account with their IDs, names, form counts, and members. Use when you need to list available workspaces or search for specific workspaces by name.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type    | Required | Example       | Description                                                                                           |
| ----------- | ------- | :------: | ------------- | ----------------------------------------------------------------------------------------------------- |
| `page`      | integer |          | `1`           | Page number for pagination. Default is 1.                                                             |
| `search`    | string  |          | `"Marketing"` | Search term to filter workspaces by name. Only workspaces matching this search term will be returned. |
| `page_size` | integer |          | `10`          | Number of items per page. Default is 10, maximum is 200.                                              |

***

### `Typeform Patch Form`

Integration name: **TYPEFORM\_PATCH\_FORM**

Tool to partially update a Typeform using JSON Patch operations. Use when you need to modify specific fields without replacing the entire form. Supports updating title, settings, theme, workspace, and other form properties.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type   | Required | Example                                                          | Description                                                                                                                                              |
| ------------ | ------ | :------: | ---------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `form_id`    | string |     ✅    | `"Y78g1cmS"`                                                     | Unique form identifier found in the form URL                                                                                                             |
| `operations` | array  |     ✅    | `[{"op":"replace","path":"/title","value":"Updated Test Form"}]` | List of JSON Patch operations to apply to the form. Each operation specifies an action (add/remove/replace), a path to the field, and optionally a value |

***

### `Typeform Patch Theme`

Integration name: **TYPEFORM\_PATCH\_THEME**

Tool to partially update a Typeform theme by ID. Updates only the specified properties while leaving other theme settings unchanged. Each provided field must be complete (e.g., if updating colors, all color subfields must be provided). Cannot modify Typeform's public built-in themes.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                | Type    | Required | Example                | Description                                                      |
| ------------------------ | ------- | :------: | ---------------------- | ---------------------------------------------------------------- |
| `font`                   | string  |          | `"Arial"`              | Font family for the theme. Must be a valid Typeform font option. |
| `name`                   | string  |          | `"Updated Test Theme"` | Name for the theme                                               |
| `colors`                 | object  |          | —                      | Colors configuration for the theme.                              |
| `fields`                 | object  |          | —                      | Configuration for fields or screens alignment and font size.     |
| `screens`                | object  |          | —                      | Configuration for fields or screens alignment and font size.     |
| `theme_id`               | string  |     ✅    | `"DlvKunmZ"`           | Unique ID for the theme to update                                |
| `background`             | object  |          | —                      | Background configuration for the theme.                          |
| `rounded_corners`        | string  |          | `"small"`              | Rounded corners setting for the theme                            |
| `has_transparent_button` | boolean |          | `true`                 | Whether the button should be transparent                         |

***

### `Typeform Update Form`

Integration name: **TYPEFORM\_UPDATE\_FORM**

Tool to update an existing Typeform by completely replacing its configuration. PUT request overwrites the entire form - any fields not included will be deleted along with their response data. Always retrieve the form first using Get Form, modify the desired properties, then send the complete updated form definition.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type   | Required | Example                    | Description                                                                                                                                                                                                                                                                                                                                                      |
| ------------------ | ------ | :------: | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `type`             | string |          | `"quiz"`                   | Form type category such as 'quiz', 'classification', 'score', 'branching', etc.                                                                                                                                                                                                                                                                                  |
| `logic`            | array  |          | —                          | Array of logic jump objects for conditional branching. Each contains: type (field), ref (field reference), and actions (array with action, condition, and details).                                                                                                                                                                                              |
| `theme`            | object |          | —                          | Theme object containing 'href' field with theme URL to apply design styling to the form.                                                                                                                                                                                                                                                                         |
| `title`            | string |          | `"Customer Feedback Form"` | The form's title/name                                                                                                                                                                                                                                                                                                                                            |
| `fields`           | array  |          | —                          | Array of form field objects defining questions and inputs. Each field must have: ref (unique reference), title (question text), type (field type like short\_text, email, multiple\_choice, etc.), properties (field-specific config), and optionally validations and attachments. Include all existing fields with their original 'id' values to preserve them. |
| `hidden`           | array  |          | —                          | Array of hidden field variable names for passing data via URL parameters.                                                                                                                                                                                                                                                                                        |
| `form_id`          | string |     ✅    | `"Y78g1cmS"`               | Unique form identifier to update                                                                                                                                                                                                                                                                                                                                 |
| `settings`         | object |          | —                          | Form settings object including language, is\_public, progress\_bar, show\_progress\_bar, show\_typeform\_branding, autosave\_progress, hide\_navigation, captcha, redirect\_after\_submit\_url, meta (with allow\_indexing, description, image), and tracking properties.                                                                                        |
| `variables`        | object |          | —                          | Variables object for tracking score, price, or enrichment calculations.                                                                                                                                                                                                                                                                                          |
| `workspace`        | object |          | —                          | Workspace object containing 'href' field with workspace URL. If not specified, form remains in current workspace.                                                                                                                                                                                                                                                |
| `welcome_screens`  | array  |          | —                          | Array of welcome screen objects shown before the form. Each contains: ref, title, properties, and optionally attachment.                                                                                                                                                                                                                                         |
| `thankyou_screens` | array  |          | —                          | Array of thank you screen objects shown after form completion. Each contains: ref, title, type, properties (show\_button, share\_icons, button\_mode, button\_text), and optionally attachment.                                                                                                                                                                  |

***

### `Typeform Update Form Messages`

Integration name: **TYPEFORM\_UPDATE\_FORM\_MESSAGES**

Tool to update custom messages for form UI elements like buttons, errors, and placeholders in Typeform. Use when you need to customize the text displayed to form respondents.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                        | Type   | Required | Example                    | Description                                                                                                      |
| -------------------------------- | ------ | :------: | -------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| `form_id`                        | string |     ✅    | `"Y78g1cmS"`               | Unique form identifier                                                                                           |
| `label_button_submit`            | string |          | `"Submit Form"`            | Text for the submit button (max 100 characters). This is the final button to submit the form.                    |
| `label_error_required`           | string |          | `"This field is required"` | Error message shown when a required field is empty (max 64 characters).                                          |
| `label_button_hint_default`      | string |          | `"Click to continue"`      | Tooltip text for the continue button (max 28 characters). Use this to provide hints about the button's function. |
| `block_short_text_placeholder`   | string |          | `"Type your answer here"`  | Placeholder text for short text input fields (max 100 characters).                                               |
| `label_button_no_answer_default` | string |          | `"Skip this question"`     | Text for the 'Continue without answering' button (max 100 characters). Shown when a question is optional.        |

***

### `Typeform Update Theme`

Integration name: **TYPEFORM\_UPDATE\_THEME**

Tool to update a theme's complete definition in Typeform. Use when you need to update all aspects of a theme including colors, fonts, and visual properties. This is a full update (PUT) operation that requires name, font, and colors to be provided. For partial updates, use PATCH instead.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                | Type    | Required | Example                | Description                                                                |
| ------------------------ | ------- | :------: | ---------------------- | -------------------------------------------------------------------------- |
| `font`                   | string  |     ✅    | `"Helvetica"`          | Font family for the theme (required for PUT requests)                      |
| `name`                   | string  |     ✅    | `"Updated Test Theme"` | Updated theme name                                                         |
| `colors`                 | object  |     ✅    | —                      | Updated color palette with question, answer, button, and background colors |
| `fields`                 | object  |          | —                      | Field settings for the theme                                               |
| `screens`                | object  |          | —                      | Screen settings for the theme                                              |
| `theme_id`               | string  |     ✅    | `"Gym4Ntp6"`           | Unique identifier for the theme to update                                  |
| `background`             | object  |          | —                      | Background settings for the theme                                          |
| `rounded_corners`        | string  |          | `"small"`              | Border radius style: none, small, or large                                 |
| `has_transparent_button` | boolean |          | `false`                | Whether buttons should be transparent                                      |

***

### `Typeform Update Workspace`

Integration name: **TYPEFORM\_UPDATE\_WORKSPACE**

Tool to update a workspace's name or manage team member access (add/remove members) in Typeform. Use when you need to rename a workspace or modify its member list using JSON Patch operations.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type   | Required | Example                                                              | Description                                                                                      |
| -------------- | ------ | :------: | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| `operations`   | array  |     ✅    | `[{"op":"replace","path":"/name","value":"Updated Workspace Name"}]` | List of patch operations to apply to the workspace. Each operation modifies a specific property. |
| `workspace_id` | string |     ✅    | `"dZMAWB"`                                                           | Unique workspace identifier                                                                      |

***

### `Typeform Upload Video`

Integration name: **TYPEFORM\_UPLOAD\_VIDEO**

Initiate a video upload to Typeform by obtaining a signed upload URL. Use this action to prepare for uploading a video file to a specific form field. After receiving the upload\_url, use it to upload the actual video file via a PUT request.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter  | Type   | Required | Example        | Description                                                                                           |
| ---------- | ------ | :------: | -------------- | ----------------------------------------------------------------------------------------------------- |
| `form_id`  | string |     ✅    | `"Y78g1cmS"`   | Unique form identifier where the video will be attached                                               |
| `field_id` | string |     ✅    | `"test_field"` | Field ID where the video media belongs within the form                                                |
| `language` | string |     ✅    | `"en"`         | ISO 639-1 format language code for automatic transcription (e.g., 'en' for English, 'es' for Spanish) |

***


---

# 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.toolhouse.ai/toolhouse/integrations/typeform.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.
