# Typeform

Build beautiful, interactive forms that people love to fill out. Collect data, accept payments, and integrate with your favorite tools.

- **Category:** forms & surveys
- **Auth:** OAUTH2
- **Composio Managed App Available?** Yes
- **Tools:** 35
- **Triggers:** 0
- **Slug:** `TYPEFORM`
- **Version:** 20260323_00

## Tools

### Create Account Workspace

**Slug:** `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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the new workspace to create |
| `account_id` | string | Yes | The ULID format identifier for the account where the workspace will be created |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Form

**Slug:** `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.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Image

**Slug:** `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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | No | Direct link to an existing image online. Either 'image' or 'url' must be provided. |
| `image` | string | No | Base64 code for the image (exclude data:image descriptors). Either 'image' or 'url' must be provided. |
| `file_name` | string | Yes | The name assigned to your image file |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create or Update Webhook

**Slug:** `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.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Theme

**Slug:** `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.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Workspace

**Slug:** `TYPEFORM_CREATE_WORKSPACE`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | The name of the workspace to create |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Form

**Slug:** `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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `form_id` | string | Yes | Unique form identifier found in the form URL |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Image

**Slug:** `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).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `image_id` | string | Yes | The unique identifier for the image to remove |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Responses

**Slug:** `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.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Theme

**Slug:** `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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `theme_id` | string | Yes | Unique theme identifier to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Webhook

**Slug:** `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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag` | string | Yes | Unique webhook name to delete |
| `form_id` | string | Yes | Unique form identifier |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Workspace

**Slug:** `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).

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get About Me

**Slug:** `TYPEFORM_GET_ABOUT_ME`

Get information about the owner account in Typeform.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get All Response Files

**Slug:** `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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `form_id` | string | Yes | Unique identifier of the form to download response files for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Background By Size

**Slug:** `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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `size` | string ("default" | "tablet" | "mobile" | "thumbnail") | Yes | 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 | Yes | Unique identifier for the image resource |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Choice Image By Size

**Slug:** `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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `size` | string ("default" | "thumbnail" | "supersize" | "supermobile" | "supersizefit") | Yes | 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 | Yes | Unique ID for the image to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Form

**Slug:** `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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `form_id` | string | Yes | Unique form identifier found in the form URL |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Form Messages

**Slug:** `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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `form_id` | string | Yes | Unique form identifier found in the form URL |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Form Responses

**Slug:** `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.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Image By Size

**Slug:** `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).

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Theme

**Slug:** `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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `theme_id` | string | Yes | Unique ID for the theme |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Webhook

**Slug:** `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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag` | string | Yes | Unique name assigned to the webhook |
| `form_id` | string | Yes | Unique form identifier |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Workspace

**Slug:** `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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `workspace_id` | string | Yes | Unique identifier for the workspace to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Forms

**Slug:** `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.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Images

**Slug:** `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.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Typeform Themes

**Slug:** `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.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Form Webhooks

**Slug:** `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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `form_id` | string | Yes | Unique form identifier for which to retrieve webhooks |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Workspaces

**Slug:** `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.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Patch Form

**Slug:** `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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `form_id` | string | Yes | Unique form identifier found in the form URL |
| `operations` | array | Yes | 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 |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Theme (Partial)

**Slug:** `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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `font` | string | No | Font family for the theme. Must be a valid Typeform font option. |
| `name` | string | No | Name for the theme |
| `colors` | object | No | Colors configuration for the theme. |
| `fields` | object | No | Configuration for fields or screens alignment and font size. |
| `screens` | object | No | Configuration for fields or screens alignment and font size. |
| `theme_id` | string | Yes | Unique ID for the theme to update |
| `background` | object | No | Background configuration for the theme. |
| `rounded_corners` | string ("none" | "small" | "large") | No | Rounded corners setting for the theme |
| `has_transparent_button` | boolean | No | Whether the button should be transparent |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Form

**Slug:** `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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string | No | Form type category such as 'quiz', 'classification', 'score', 'branching', etc. |
| `logic` | array | No | 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 | No | Theme object containing 'href' field with theme URL to apply design styling to the form. |
| `title` | string | No | The form's title/name |
| `fields` | array | No | 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 | No | Array of hidden field variable names for passing data via URL parameters. |
| `form_id` | string | Yes | Unique form identifier to update |
| `settings` | object | No | 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 | No | Variables object for tracking score, price, or enrichment calculations. |
| `workspace` | object | No | Workspace object containing 'href' field with workspace URL. If not specified, form remains in current workspace. |
| `welcome_screens` | array | No | Array of welcome screen objects shown before the form. Each contains: ref, title, properties, and optionally attachment. |
| `thankyou_screens` | array | No | 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. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Form Messages

**Slug:** `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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `form_id` | string | Yes | Unique form identifier |
| `label_button_submit` | string | No | Text for the submit button (max 100 characters). This is the final button to submit the form. |
| `label_error_required` | string | No | Error message shown when a required field is empty (max 64 characters). |
| `label_buttonHint_default` | string | No | Tooltip text for the continue button (max 28 characters). Use this to provide hints about the button's function. |
| `block_shortText_placeholder` | string | No | Placeholder text for short text input fields (max 100 characters). |
| `label_buttonNoAnswer_default` | string | No | Text for the 'Continue without answering' button (max 100 characters). Shown when a question is optional. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Theme

**Slug:** `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.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Workspace

**Slug:** `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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `operations` | array | Yes | List of patch operations to apply to the workspace. Each operation modifies a specific property. |
| `workspace_id` | string | Yes | Unique workspace identifier |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Upload Video

**Slug:** `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.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |