Improved
Reviews V1: review, Q&A and media response fields explained
November 16th, 2026
The Reviews V1 reference now describes fields that were undocumented or described wrongly:
- Errors: the Errors guide lists the V1 error fields:
error_typeis the error class,uuidis the request ID to give Yotpo support, andsandrare internal fields you can ignore. - Reviews: on Create review (synchronous) and Retrieve reviews for a user,
user_typenow explainsUserandAnonymousUser, review title and text note that they're returned HTML-encoded, and fields such asuser_vote,newandaccount.domainare described. Social posting fields, mentions andLocation_idxare marked as legacy. - Create review: on Create review,
creation_request_idis returned only when request ID tracking is on. Use it to match thereview_createwebhook to your request. It can't be used to look up the review. - Q&A: on Retrieve questions and answers for a product,
sorted_public_answersnow states its order (net votes, then newest day first), and the asker's and answerer'sscoreandbadgesare marked as legacy. There and on Retrieve product questions,is_social_connectedis marked as legacy (alwaysfalse). - Visual UGC: on Product images, the video fields are marked "video only" and are
nullfor images.ref_idandpost.hashtag_nameare described, andproduct_info,tagged_products[].social_linksandshop_ownerare marked as legacy (alwaysnull). There and on Photos by album,tagged_products[].score,reviews_countandpermission_request_statusare described.
Request and response formats haven't changed.
