> For the complete documentation index, see [llms.txt](https://whitepaper.aitech.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://whitepaper.aitech.io/agentforge/tools/typeform.md).

# typeform

[Typeform](https://www.typeform.com/) is a user-friendly platform for creating conversational forms, surveys, and quizzes with a focus on engaging user experience.

With Typeform, you can:

* **Create interactive forms**: Design beautiful, conversational forms that engage respondents with a unique one-question-at-a-time interface
* **Customize your experience**: Use conditional logic, hidden fields, and custom themes to create personalized user journeys
* **Integrate with other tools**: Connect with 1000+ apps through native integrations and APIs
* **Analyze response data**: Get actionable insights through comprehensive analytics and reporting tools

The Agent Forge Typeform integration lets your agents programmatically interact with your Typeform data in their workflows. Agents can retrieve form responses, process submission data, and incorporate user feedback directly into decision-making.

This is valuable for lead qualification, customer feedback analysis, and data-driven personalization.

By connecting Agent Forge with Typeform, you can create intelligent automations that transform form responses into actionable insights—analyzing sentiment, categorizing feedback, generating summaries, and triggering follow-up actions based on specific response patterns.

### Usage Instructions

Access and retrieve responses from your Typeform forms. Integrate form submissions data into your workflow for analysis, storage, or processing.

### Where to Get Your Typeform Personal Access Token (PAT)

You can generate and manage your Personal Access Tokens (PATs) directly within your Typeform account settings.

Here is the step-by-step process:

{% stepper %}
{% step %}

### Log in to your Typeform account.

Navigate to the Typeform website and sign in.
{% endstep %}

{% step %}

### Access Account Settings:

In the top-left corner of the dashboard, click the **dropdown menu** next to your username and select **"Account"**.
{% endstep %}

{% step %}

### Navigate to Tokens:

In the left-hand menu, find and click the **"Personal tokens"** section.
{% endstep %}

{% step %}

### Generate a New Token:

* Click the **"Generate a new token"** button.
* **Name the Token:** Provide a descriptive name (e.g., `WebApp Integration Key`).
* **Set Permissions (Scopes):** Select the necessary "scopes" or permissions that the token will have. You can grant it full access or be more specific based on your integration needs.
  {% endstep %}

{% step %}

### Copy and Securely Save the Token:

* Click **"Generate token"**.
* **Important:** Your new token will only be displayed once. **Copy it immediately** and save it securely, as you will not be able to retrieve it later. Treat this token as a password.
  {% endstep %}
  {% endstepper %}

### Tools

#### `typeform_responses`

Retrieve form responses from Typeform

**Input**

| Parameter   | Type   | Required | Description                                                     |
| ----------- | ------ | -------- | --------------------------------------------------------------- |
| `formId`    | string | Yes      | Typeform form ID                                                |
| `apiKey`    | string | Yes      | Typeform Personal Access Token                                  |
| `pageSize`  | number | No       | Number of responses to retrieve (default: 25)                   |
| `since`     | string | No       | Retrieve responses submitted after this date (ISO 8601 format)  |
| `until`     | string | No       | Retrieve responses submitted before this date (ISO 8601 format) |
| `completed` | string | No       | Filter by completion status (true/false)                        |

**Output**

| Parameter     | Type   | Description          |
| ------------- | ------ | -------------------- |
| `total_items` | number | Total response count |
| `page_count`  | number | Total page count     |
| `items`       | json   | Response items       |

#### `typeform_files`

Download files uploaded in Typeform responses

**Input**

| Parameter    | Type    | Required | Description                                                 |
| ------------ | ------- | -------- | ----------------------------------------------------------- |
| `formId`     | string  | Yes      | Typeform form ID                                            |
| `responseId` | string  | Yes      | Response ID containing the files                            |
| `fieldId`    | string  | Yes      | Unique ID of the file upload field                          |
| `filename`   | string  | Yes      | Filename of the uploaded file                               |
| `inline`     | boolean | No       | Whether to request the file with inline Content-Disposition |
| `apiKey`     | string  | Yes      | Typeform Personal Access Token                              |

**Output**

| Parameter     | Type   | Description          |
| ------------- | ------ | -------------------- |
| `total_items` | number | Total response count |
| `page_count`  | number | Total page count     |
| `items`       | json   | Response items       |

#### `typeform_insights`

Retrieve insights and analytics for Typeform forms

**Input**

| Parameter | Type   | Required | Description                    |
| --------- | ------ | -------- | ------------------------------ |
| `formId`  | string | Yes      | Typeform form ID               |
| `apiKey`  | string | Yes      | Typeform Personal Access Token |

**Output**

| Parameter     | Type   | Description          |
| ------------- | ------ | -------------------- |
| `total_items` | number | Total response count |
| `page_count`  | number | Total page count     |
| `items`       | json   | Response items       |

### Notes

* Category: `tools`
* Type: `typeform`


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://whitepaper.aitech.io/agentforge/tools/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.