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

# Typeform

> Let your UnleashX agent read your Typeform forms and responses, and manage forms.

# Typeform

> **In one line:** Connect Typeform so your UnleashX agent can list your forms, pull responses, and create or update forms — all in plain language.

|                    |                                                                                                                       |
| ------------------ | --------------------------------------------------------------------------------------------------------------------- |
| **Category**       | Forms & Surveys                                                                                                       |
| **Authentication** | Personal access token                                                                                                 |
| **Setup time**     | \~2 minutes                                                                                                           |
| **Difficulty**     | Easy                                                                                                                  |
| **Best for**       | Teams that collect data with Typeform and want an AI agent to read responses, summarize submissions, and manage forms |

## 1. Overview

Typeform is a form and survey builder known for its conversational, one-question-at-a-time experience. Your account holds the forms you've built and every response people submit.

Once connected to UnleashX, your agent can list your forms, read a form's structure, pull and summarize responses, create new forms, and manage webhooks so downstream automations fire when a response arrives. It works against your live Typeform account using a personal access token, so it acts with your own permissions.

Connecting Typeform to UnleashX turns your forms into a live data source your agent can act on. Instead of exporting a spreadsheet to see what people submitted, you ask your agent to pull the latest responses or summarize the results.

## 2. What you'll need

* A Typeform account.
* A **personal access token** generated from your account settings (see Section 3).
* An UnleashX account with access to **Data Connectors**.

<Note>
  You paste a **personal access token**. UnleashX sends it to the Typeform API as a `Bearer` credential.
</Note>

## 3. Get your credentials

Typeform MCP authenticates with a **personal access token**.

<Steps>
  <Step title="Open the admin portal">
    Sign in to Typeform and go to the admin portal.
  </Step>

  <Step title="Open Account Settings">
    On the top right, click your profile **icon** → **Account Settings**.

    <img src="https://mintcdn.com/unleashx/WKTnCPRJnwZX5nct/images/mcp/typeform/setup/01-account-settings.png?fit=max&auto=format&n=WKTnCPRJnwZX5nct&q=85&s=68b472ab627c5599d6c37c88d131e3be" alt="Open Account Settings from the Typeform admin portal" width="2446" height="1168" data-path="images/mcp/typeform/setup/01-account-settings.png" />
  </Step>

  <Step title="Open Personal Tokens">
    In the left sidebar, click **Personal Tokens**.
  </Step>

  <Step title="Generate a new token">
    Click **Generate a new token**, give it a name (e.g. "UnleashX"), choose the scopes you want it to have, and generate it. Copy the token now — Typeform shows it only once.

    <img src="https://mintcdn.com/unleashx/WKTnCPRJnwZX5nct/images/mcp/typeform/setup/02-generate-token.png?fit=max&auto=format&n=WKTnCPRJnwZX5nct&q=85&s=4cdb7111d20da74befc05ffab99b61fc" alt="Generate a new personal token" width="2158" height="1260" data-path="images/mcp/typeform/setup/02-generate-token.png" />
  </Step>

  <Step title="Paste it into UnleashX">
    Paste the token when connecting (Section 4).
  </Step>
</Steps>

<Warning>
  A personal access token can act on your Typeform account within its scopes. Store it securely and delete it from Typeform if it's ever exposed.
</Warning>

### Permissions this token grants UnleashX

| Access          | Why UnleashX needs it                                         |
| --------------- | ------------------------------------------------------------- |
| Read forms      | List and read your forms and their fields.                    |
| Manage forms    | Create, update, and delete forms (if you grant write scopes). |
| Read responses  | Fetch and summarize form submissions.                         |
| Manage webhooks | Create webhooks so workflows can trigger on new responses.    |

## 4. Connect on UnleashX

<Steps>
  <Step title="Open your agent">
    Go to `https://www.tryunleashx.com` and open the agent you want to connect.
  </Step>

  <Step title="Open Data Connectors">
    Inside the agent, go to **Data Connectors**.
  </Step>

  <Step title="Find Typeform">
    Locate **Typeform** and click **Connect** (or **Add** / **Configure**).
  </Step>

  <Step title="Paste your token">
    Paste your **personal access token** and click **Connect**.
  </Step>

  <Step title="Confirm success">
    UnleashX validates the token and the Typeform connector shows a **Connected** badge.
  </Step>
</Steps>

### Use Typeform in a Workflow

Once connected, you can add **Typeform** to any automation from the **Workflows** builder. Its triggers and tools appear in the Apps panel, marked with an **MCP** badge.

<Steps>
  <Step title="Add a trigger or action node">
    Open **Workflows → New Workflow**. On the canvas, click **+ Add Trigger** (or the **+** below any node) to add a step.

    <img src="https://mintcdn.com/unleashx/LXZeho1M8XzFkz0k/images/mcp/workflows/05-add-trigger.png?fit=max&auto=format&n=LXZeho1M8XzFkz0k&q=85&s=449a0c03b0c7b40e571ec02373a85259" alt="Add a trigger on the workflow canvas" width="1390" height="722" data-path="images/mcp/workflows/05-add-trigger.png" />
  </Step>

  <Step title="Pick Typeform from the Apps panel">
    In the **Paths** panel, open the **Apps** tab and select **Typeform**. Use the search box if you have many connectors.

    <img src="https://mintcdn.com/unleashx/LXZeho1M8XzFkz0k/images/mcp/workflows/06-apps-list.png?fit=max&auto=format&n=LXZeho1M8XzFkz0k&q=85&s=bbb8bb6e668c4f8e1f6fd5e4955a45f0" alt="Choose your app from the Apps list" width="2446" height="1550" data-path="images/mcp/workflows/06-apps-list.png" />
  </Step>

  <Step title="Choose a trigger or tool">
    Pick the trigger or action you want (for example, "new response"). Configure its fields — required fields are marked with a red asterisk (\*).
  </Step>

  <Step title="Add or select your account">
    Under **Selected account**, choose an already-connected account, or click **Add Account** to connect one now.
  </Step>

  <Step title="Save and test">
    Fill in the remaining fields and click **Save**. Use **Test** to verify the step, then toggle **Publish** when the workflow is ready.
  </Step>
</Steps>

<Note>
  The steps are the same for every connector. For the full workflow builder guide, see [Using MCP in Workflows](/mcp/workflows).
</Note>

## 5. Available tools

| Tool             | What it does                             | Changes data? |
| ---------------- | ---------------------------------------- | ------------- |
| List Forms       | Lists the forms in your account.         | No            |
| Get Form         | Retrieves a form's structure and fields. | No            |
| Create Form      | Creates a new form.                      | ✏️ Yes        |
| Update Form      | Updates an existing form.                | ✏️ Yes        |
| Delete Form      | Deletes a form.                          | ⚠️ Yes        |
| List Responses   | Retrieves responses submitted to a form. | No            |
| Get Response     | Retrieves a single response.             | No            |
| Delete Responses | Deletes specified responses.             | ⚠️ Yes        |
| List Webhooks    | Lists webhooks configured on a form.     | No            |
| Create Webhook   | Creates a webhook on a form.             | ✏️ Yes        |
| Delete Webhook   | Removes a webhook from a form.           | ✏️ Yes        |
| Get Workspaces   | Lists the workspaces in your account.    | No            |

## 6. Example usage

**"How many people completed our onboarding survey this week? Summarize what they said."**
→ Runs List Responses on the form, then summarizes the submissions.

**"Create a webhook on the contact form so my workflow runs whenever someone submits it."**
→ Runs Create Webhook on the form pointing at your workflow.

## 7. Permissions & data access

**UnleashX can:**

* List and read your forms, fields, and responses.
* Create, update, and delete forms (with write scopes).
* Manage webhooks on your forms.

**UnleashX cannot:**

* Access forms or workspaces your token isn't scoped for.
* Change your Typeform account or billing settings.

**To disconnect:** In UnleashX, open **Data Connectors → Typeform → Disconnect**. Then delete the token in Typeform under **Account Settings → Personal Tokens**. Disconnecting and deleting the token removes access immediately.

## 8. Troubleshooting

| Problem                   | What it means                              | How to fix it                                       |
| ------------------------- | ------------------------------------------ | --------------------------------------------------- |
| **401 Unauthorized**      | The token is invalid or was deleted.       | Generate a new personal access token and reconnect. |
| **403 Forbidden**         | The token lacks the scope for that action. | Regenerate the token with the needed scopes.        |
| **404 Not found**         | The form ID is wrong or was deleted.       | Have the agent list forms to find the correct ID.   |
| **429 Too Many Requests** | You hit Typeform's rate limit.             | Wait and retry; space out bulk requests.            |

For general MCP issues, see [/mcp/integrations](/mcp/integrations).

## 9. Frequently asked questions

**Is my form data stored by UnleashX?**
No. UnleashX reads and writes through the Typeform API live per request; it doesn't keep a copy of your forms or responses.

**Can the agent delete forms or responses?**
Yes — tools marked ⚠️ make permanent changes and only work if your token has write scopes. Use them deliberately.

**Can multiple people connect Typeform?**
Yes. Each person generates their own personal access token and connects separately.

## 10. References

* Typeform API reference: [https://www.typeform.com/developers/](https://www.typeform.com/developers/)
* Create a personal access token: [https://www.typeform.com/developers/get-started/personal-access-token/](https://www.typeform.com/developers/get-started/personal-access-token/)
* Responses API: [https://www.typeform.com/developers/responses/](https://www.typeform.com/developers/responses/)
* Webhooks: [https://www.typeform.com/developers/webhooks/](https://www.typeform.com/developers/webhooks/)