Reviews (developers)
Santeri
Last Update a year ago
Reviews are used to store testimonials from your customers. Reviews can be used in embeds or popups on your site. Review sources can currently be Trustmary (customers answering surveys), Facebook (import), Google (import) or custom (API or manually added to Trustmary).
Reviews object
Attributes:
eid string
External identifier, use your CRM/ERP review identifier to sync data back to your system
nps integer
Answer to the question "How likely are you to recommend our service to a friend or colleague?" On a scale of 0-10.
comment string
Company of the person who left the review.
name stringName/nick of the person who left the review.
company string
Company of the person who left the review.
location string
Location of the person who left the review. Eg. City.
title string
Title of the person who left the review. Eg. CEO.
picture URL **Subject to change**
Web safe picture of the person who left the review. **We are currently hotlinking to this URL, so please use a static URL. This will be fixed in the future.**
video string **Subject to change**
Web safe video review. **We are currently hotlinking to this URL, so please use a static URL. This will be fixed in the future.**
published boolean
Should the review be published in Trustmary. Defaults to false.
created_at ISO 8601 with timezone
Time review was created.
updated_at ISO 8601 with timezone
Time of last action performed on the review object.
deleted_at ISO 8601 with timezone or null
If review was deleted, time of the last deletion.
Creating/updating a Review
Body attributes:
eid string (optional)
External identifier, use your CRM/ERP review identifier to sync data back to your system
nps integer (optional)
Answer to the question "How likely are you to recommend our service to a friend or colleague?" On a scale of 0-10.
comment string (optional)
Company of the person who left the review.
name string (optional)
Name/nick of the person who left the review.
company string (optional)
Company of the person who left the review.
location string (optional)
Location of the person who left the review. Eg. City.
title string (optional)
Title of the person who left the review. Eg. CEO.
picture URL (optional) **Subject to change**
Web safe picture of the person who left the review. **We are currently hotlinking to this URL, so please use a static URL. This will be fixed in the future.**
video string (optional) **Subject to change**
Web safe video review. **We are currently hotlinking to this URL, so please use a static URL. This will be fixed in the future.**
published boolean (optional)
Should the review be published in Trustmary. Defaults to false.
Returning
Attributes
review review_object
Contains the created/updated review object.
action string
If the eid was unique or not set action will be ADD_REVIEW, otherwise corresponding review was updated and the action will be UPDATE_REVIEW.