> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Typeform

> Build and manage forms, themes, workspaces, images, and responses in Typeform via your connected account.

Use Typeform when your workflow needs to create forms, update them, or review incoming responses. You can also manage workspaces and customize themes and images.

## Configuration

| Option | Required | Description |
| - | - | - |
| Name | No | Label for the step in the workflow canvas. |
| Authentication | Yes | The connected Typeform account to use for this step. |
| Action | Yes | The Typeform action to perform (for example Get account details, List forms, Get form, Create form). |
| Arguments | Yes | Per-action form fields generated from the action's schema. Each text field has an **Insert Variable** button for injecting `{{placeholder}}` values. A **Raw JSON** tab is available for advanced usage. |
| When the step fails | No | Controls whether the workflow should **Terminate Workflow** or **Continue** if this step fails. |

Before you configure this step, connect Typeform in **Integrations** for your workspace using the sign-in flow. If no active connection is available, the step shows a warning with a link to **Integrations** instead of the account selector.

## Arguments form

When you select an action, the **Arguments** section renders a form driven by the action's input schema. Fields that refer to existing records include dropdown pickers.

Switch to the **Raw JSON** tab when you prefer to write the full arguments object by hand. Changes in either tab stay in sync.

## Common actions

| Action | Description |
| - | - |
| **Get account details** | Get the connected Typeform account details. |
| **List forms** | List forms in your Typeform account. |
| **Get form** | Retrieve a form's full configuration. |
| **Create form** | Create a new Typeform form. |
| **Patch form** | Partially update a form with JSON Patch operations. |
| **Update form** | Replace a form's configuration. |
| **Get form responses** | Retrieve responses for a form. |
| **Update form messages** | Update a form's custom UI messages. |
| **List workspaces** | List workspaces in your account. |
| **Get workspace** | Retrieve a workspace's details. |
| **List themes** | List themes in your Typeform account. |
| **Get theme** | Retrieve a theme's configuration. |
| **Create theme** | Create a new custom theme. |

Destructive actions, such as deleting records, are not available in the workflow action picker.

## Output

This step stores the Typeform response as the step output. The shape of the response depends on the action.

Use the full output reference in later steps:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## Example

1. Open **Integrations** and connect Typeform if you have not already done that.
2. Add a **Typeform** step to your workflow.
3. Select a connected account in **Authentication**.
4. Choose **Get account details** in **Action**.
5. Fill in the required fields. Use **Insert Variable** to reference an earlier step's output for any field value.
6. Click **Run** in the step header to test the action, then review the returned payload in **Output**.

## Use cases

### Create a lead form

1. Create form
2. Patch form
3. Update form messages

### Review survey replies

1. List forms
2. Get form
3. Get form responses

### Set up a new workspace

1. Create workspace
2. Update workspace
3. List workspaces

## Notes

* This step depends on a connected Typeform integration in your workspace.
* The workflow action picker shows a curated set of actions. Agents with the Typeform tool can use more of them.
* The sign-in screen may show third-party authorization branding.

## Using Typeform as an Agent Tool

You can also add Typeform as a tool in the **Agent Editor**. Open the agent, click **Add tool**, and select **Typeform**. In the tool settings panel, choose the connected account the agent should use. The agent calls Typeform actions when they are relevant to the conversation.

See also: [Integrations](https://docs.fetchhive.com/workspace/integrations.md), [Creating and Editing](https://docs.fetchhive.com/workflows/creating-and-editing.md), and [Testing and Iteration](https://docs.fetchhive.com/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.