Reviews (developers)

Santeri

Last Update 8 months 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.

Still need help? Message Us