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, or for a standalone testimonial page, use Wall of Love.

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

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.Check form_kind from list_forms first if you are unsure which kind you have.

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:

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.
Translate the values, then pass them back to save_form_translation with the same keys and that language_id.

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.

Getting Started

Tools Reference

Guides

Available Tools

Review Types a Form Can Accept

Legacy and AI-Native Forms

Which Tool Gives Which Numbers

Translating a Form

​Available Tools

​Review Types a Form Can Accept

​Legacy and AI-Native Forms

​Which Tool Gives Which Numbers

​Translating a Form

Available Tools

Review Types a Form Can Accept

Legacy and AI-Native Forms

Which Tool Gives Which Numbers

Translating a Form