HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
API Reference

Create Client Review

🚧

This endpoint is in beta and subject to change.

A beta revision header (2025-01-15.pre) is required to use our beta APIs. Klaviyo APIs in beta are not intended for use in production. See our versioning and deprecation policy for more information.

Create a review with the given ID. This endpoint is for client-side environments only.

Rate limits:
Burst: 10/s
Steady: 150/m

Query Params
string
required

Your Public API Key / Site ID. See this article for more details.

Body Params
object
required
string
required
object
required
string
required

The type of this review -- either a review or a question

string
required

The email of the author of this review

string
required

The author of this review

string
required

The content of this review

string

The incentive type for the review

object

The product associated with this review

string
required

The external ID of the product

string
required

The integration key of the product in lowercase

integer

The rating of this review on a scale from 1-5. If the review type is "question", this field will be null.

string

The title of this review

array of objects

Custom question and answers for the review

custom_questions
string
required

The ID of the custom question

array of strings
required

The answers to the custom question

answers*
array of strings

The list of images submitted with this review (represented as a list of urls or base-64 encoded data-uri). If there are no images, this field will be an empty list.

images
object
object
object
string
required
string
required

The Order ID related to the review

Headers
string
required
Defaults to 2025-01-15.pre

API endpoint revision (format: YYYY-MM-DD[.suffix])

Responses
202

Success

Language