Orders

Pre-populate surveys with verified customer details.

About Orders

Sharing your customer's order details with GetReviews is optional, but does have a few benefits.

  1. If your survey offers respondents a giveaway for their feedback, providing Order IDs allows us to validate the review before triggering integrations with 3PL, etc.

  2. If you want to enforce customers to wait X days before writing reviews, providing Order IDs allows us to enforce this delay.

  3. You may auto-identify customers during survey initialization, skipping the data-gathering steps (product purchased, customer name / email, etc) as well as validating reviewer authenticity (benefits 1-2 above)

To provide order data itself you may upload CSVs inside our Upload Center or send data programmatically via our API.

Create an Order

Endpoint: /orders Method: POST

Sample Body:

{
    "order_id": "888-888-123456779",
    "order_date": "2023-04-24",
    "name": "Tommy Tutone",
    "email": "tommy@heath.com",
    "phone": "+15558675309",
    "marketplace_id": 10,
    "survey_code": "9594fc",
    "product_id": 3189,
    "campaign_id": 9
}

Sample Response:

{"status"=>true,
 "data"=>
  {"id"=>717066,
   "order_id"=>"888-888-123456779",
   "order_date"=>nil,
   "marketplace_id"=>10,
   "name"=>"Tommy Tutone",
   "email"=>"tommy@heath.com",
   "phone"=>"+15558675309",
   "code"=>"qwerty",
   "survey_url"=>"https://app.getreviews.ai/survey/redirect/qwerty"}
}

Notes

Order records will be de-duplicated based on the order_id attribute. If 2+ payloads are received with the same order_id value, only the first will be used to create an Order.

Error Messages

"Marketplace with ID: X doesn't exist" // marketplace not found

"{{ Marketplace Name }} isn't enabled on this account" // marketplace not enabled

"Survey code is mandatory" // survey_code param not included 

"Survey with code: X doesn't exist // survey not found

"Order already exists" // an order with this order_id already exists on the account

Last updated