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

# Forms

> Tools for creating and managing review collection forms.

Forms are shareable links where your customers can submit written, video, audio, or screen-recorded reviews. These tools let you create forms, customize them, and track submissions. Forms are for **collecting** reviews. To **display** reviews on your website, use [Widgets](/mcp/tools/widgets), or for a standalone testimonial page, use [Wall of Love](/mcp/tools/pages).

## Available Tools

| Tool                            | Description                                                                                                                                               | Try asking                                                                               |
| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| `list_forms`                    | List all review collection forms in your workspace, with views, review counts, and conversion rate per form                                               | "Which of my forms has the best conversion rate?"                                        |
| `get_form`                      | Look up a form's name, settings, and which fields it asks for                                                                                             | "Show me the details of my feedback form"                                                |
| `get_form_share`                | Get the customer-facing link and QR code for a form                                                                                                       | "Give me the shareable link for my review form"                                          |
| `get_form_stats`                | See a form's collected review counts by type, and how many times it has been opened                                                                       | "How many submissions has my review form received?"                                      |
| `create_review_collection_form` | Create a new form, choosing the heading, which review types to accept, what to ask reviewers, and the branding                                            | "Create a review form called 'Customer Feedback' that accepts written and video reviews" |
| `update_form`                   | Edit any part of a legacy form: heading, review types, button labels, star rating, reviewer fields, custom questions, thank-you page, colours, custom CSS | "Change the primary color of my review form to blue"                                     |
| `get_form_translation`          | Get a form's translatable text in a target language                                                                                                       | "Get the Spanish text for my customer feedback form"                                     |
| `save_form_translation`         | Save translated text for a form in a specific language                                                                                                    | "Translate my review form into Spanish and save it"                                      |

## Review Types a Form Can Accept

| Type    | What the reviewer does                                 |
| ------- | ------------------------------------------------------ |
| Written | Types their review                                     |
| Video   | Records a video with their camera                      |
| Audio   | Records a voice review                                 |
| Screen  | Records their screen, useful for software walkthroughs |

Each can be turned on or off, and each has its own button label you can reword. All are enabled by default, so name the ones you want turned **off**.

## Legacy and AI-Native Forms

Every form returned by `list_forms` carries a `form_kind`:

| `form_kind` | What it is                          | Editable over MCP?      |
| ----------- | ----------------------------------- | ----------------------- |
| `legacy`    | The standard review collection form | Yes, with `update_form` |
| `ai_native` | An AI interview form                | No, web app only        |

<Warning>
  `update_form` and the translation tools work on **legacy forms only**. Calling them on an AI-native form fails. Edit AI interview forms in the [Feedspace dashboard](https://app.feedspace.io).

  Check `form_kind` from `list_forms` first if you are unsure which kind you have.
</Warning>

## Which Tool Gives Which Numbers

The two stats sources are not interchangeable:

* **`get_form_stats`** returns review counts by type (`video_feeds_count`, `audio_feeds_count`, `text_feeds_count`) and how many times the form was opened (`logs_count`).
* **`list_forms`** returns the numbers the dashboard shows: `hits`, `reviews`, and `conversion_rate`.

If you want views and conversion rate, use `list_forms`.

## Translating a Form

Translation is a two-step round trip:

1. Call `get_form_translation` with a `formUniqueId` and a `targetLanguage` code (for example `es`, `fr`, `hi`, `ar`). It returns the translatable strings keyed by translation key, such as `landing__title` and `thankyou_title`, plus a `language_id`.
2. Translate the values, then pass them back to `save_form_translation` with the same keys and that `language_id`.

<Note>
  Translations are supported on legacy forms only. The first request for a new language generates the translation and can be slow. If it times out, call again, as the result is cached after the first run.

  Saving a translation adds a language to the form; it does not change the form's base copy.
</Note>