Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.masivo.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Review forms in Masivo

Navigate to Review forms in the left sidebar. The section has two tabs:
  • Review forms — list and manage review form definitions
  • Reviews — all reviews across forms

​
Creating a new review form

On the Review forms tab, click New form (requires review_forms write permission). You land on the editor with two main sections: Base Settings and Fields.

​
Base settings

Configure:
  • Name — unique per account (used internally and in lists)
  • Description — optional internal notes
  • Type — Rating, Comment, Thread, or Custom
  • Status — Active or Inactive (only active forms are available via the Storefront API)

​
Fields

Use Add field to define each question or input that channels must send when creating a review. For each field set:
  • Field name — API key used in answers (for example score)
  • Label — display label for your UI
  • Type — Score, Text, Select, or Multi select
  • Required — whether the answer is mandatory
Additional settings by type:
  • Score — min and max values (default 1–5)
  • Select / Multi select — use Add option for each choice (label and value)
  • Images — optional, up to five per field; use Add image, then Select an image to pick or upload from your multimedia library, and set Alt text
Field names must be unique within the form and should stay stable after launch. Clients submit answers keyed by field name, not by label.
When you are done, click Save in the form actions panel to create the review form.

​
Editing and deleting

Return to Review forms in the sidebar. In the table, each row shows the form name and actions:
  • View — open reviews for that form only
  • Edit — update settings and fields (requires review_forms write)
  • Delete — soft-delete the form (requires review_forms delete)
The edit URL follows /review-forms/{reviewFormId}/update.

​
Reviewing submissions

​
All reviews

Open Reviews in the secondary navigation (path /review-forms/reviews) to see every review for the account. Use table filters and search to narrow results.

​
Per review form

From the Review forms tab, click View on a row, or go to /review-forms/{reviewFormId}. You see only reviews for that form. The reviews table includes:
  • Received — submission timestamp
  • Customer — customer_id or - for anonymous
  • Source, Platform, Brand, Channel — attribution dimensions
  • Answers — JSON payload keyed by field names

​
Next steps

To load review form definitions and submit reviews from your app, follow Submit reviews in the API reference. For domain concepts (field types, events, permissions), see Review forms.