Create new reviews | Judge.me

Create new reviews

For advanced users that want to generate reviews outside of the Judge.me system, an API endpoint to create reviews is provided.

Note: There is no need to use the API. Our app, including review creation from our review widget form and review request in-email review form, works out of the gate without any special setup.

The API endpoint to create a new review is:

POST https://judge.me/reviews

Param Name Required Param Description
name yes Reviewer's display name
email yes Reviewer's email
rating yes Review's rating (1..5)
title yes Review's title (100 characters max)
body yes Review's body (2000 characters max)
id yes Shopify ID of the product
product_title no Title of the product
handle no Shopify handle of the product
url yes Custom domain of the shop. You can use the returned value from document.domain. E.g. example.com
shop_domain optional Shopify domain of the shop. E.g. shop-name.myshopify.com. We will only use this param if we cannot find your shop via url param.

Note

200 Status always: we process the review creation in our background server so we always respond with status 200 even if your request params are incorrect. But if your params are correct, most of the time, the review is created only a few seconds after you make the request.