Skip to main content
POST
/
review-forms
/
{id}
/
reviews
cURL
curl --request POST \
  --url https://app.masivo.ai/api/storefront/v1/review-forms/{id}/reviews \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "source": "app",
  "answers": {
    "score": 4,
    "reason": [
      "wait_time"
    ],
    "comment": "Good follow-up"
  },
  "customer_id": "<string>",
  "platform": "ios",
  "brand_id": "<string>",
  "store_id": "<string>",
  "channel_id": "<string>",
  "respondent": {
    "name": "Jane Doe"
  },
  "metadata": {
    "trip_id": "trip_1"
  }
}
'
{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "review_form_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "event_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "customer_id": "<string>",
    "source": "<string>",
    "platform": "<string>",
    "brand_id": "<string>",
    "store_id": "<string>",
    "channel_id": "<string>",
    "answers": {
      "score": 4,
      "reason": [
        "wait_time"
      ],
      "comment": "Good follow-up"
    },
    "respondent": {},
    "metadata": {},
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string<uuid>
required

The form unique identifier

Body

application/json
​
source
string
required

Origin of the submission (for example app, web, kiosk)

Example:

"app"

​
answers
object
required

Answers keyed by field name. SCORE: number. TEXT: string. SELECT: string option value. MULTI_SELECT: array of option values.

Example:
{
  "score": 4,
  "reason": ["wait_time"],
  "comment": "Good follow-up"
}
​
customer_id
string | null

Omit for anonymous responses

​
platform
string | null
Example:

"ios"

​
brand_id
string | null
​
store_id
string | null
​
channel_id
string | null
​
respondent
object
Example:
{ "name": "Jane Doe" }
​
metadata
object
Example:
{ "trip_id": "trip_1" }

Response

Review created

​
data
object