# Typeform

Manage Typeform: forms, responses, and webhooks. Exposes **18 actions** covering the full API surface
the agent needs - read and write.

## What it can do

| Method | What it does |
| --- | --- |
| `typeform_me` | Get authenticated user info (ID, email, name) - GET /me. |
| `typeform_list_forms` | List all forms in user account or workspace - GET /forms. |
| `typeform_get_form` | Get one form (all metadata, fields, logic) - GET /forms/{form_id}. |
| `typeform_create_form` | Create a new form - POST /forms. |
| `typeform_update_form` | Update form metadata (title, description, theme, tags) - PATCH /forms/{form_id} (JSON body, partial). |
| `typeform_delete_form` | Delete a form permanently - DELETE /forms/{form_id}. |
| `typeform_get_form_theme` | Get a form's theme (colors, font, etc.) - GET /forms/{form_id}/theme. |
| `typeform_list_form_responses` | List form responses - GET /forms/{form_id}/responses. |
| `typeform_get_form_response` | Get one response's full data - GET /forms/{form_id}/responses/{response_id} (response_id is the response UUID/token). |
| `typeform_list_form_images` | List images uploaded for a form (used in question/choice images) - GET /forms/{form_id}/images. |
| `typeform_upload_form_image` | Upload an image for use in form (questions, choice images) - POST /forms/{form_id}/images. |
| `typeform_list_workspaces` | List all workspaces the user is a member of - GET /workspaces. |
| `typeform_get_workspace` | Get one workspace's details - GET /workspaces/{workspace_id}. |
| `typeform_list_workspace_forms` | List forms in a workspace - GET /workspaces/{workspace_id}/forms. |
| `typeform_get_workspace_teams` | List teams in a workspace - GET /workspaces/{workspace_id}/teams. |
| `typeform_list_team_members` | List members of a team - GET /teams/{team_id}/members. |
| `typeform_get_form_statistics` | Get summary statistics for a form - GET /forms/{form_id}/statistics. |
| `typeform_export_form_responses_csv` | Export form responses (streaming CSV download) - GET /forms/{form_id}/responses/download. |

## How to get credentials

This connector uses **OAuth 2.0**. In FlyMyAI, open the tool and click
**Connect** - you'll be redirected to Typeform to authorize, then back to
FlyMyAI. There is no API key to paste.

> The OAuth app must be registered by FlyMyAI for this provider. If you see
> *"connection not configured"*, the provider's client credentials are still
> being set up - check back shortly.

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| _(none)_ | Connect via OAuth - nothing to paste. |

## Troubleshooting

- **`401 Unauthorized` / `403 Forbidden`** - the OAuth connection expired or was revoked - reconnect.
- **`429 Too Many Requests`** - you hit the provider rate limit; retry after a short backoff.
- **Unexpected `4xx` on writes** - double-check required fields; the agent confirms before write actions.

## Links

- [Typeform API documentation](https://www.typeform.com/developers/get-started)