Klaviyo Integration

The Klaviyo integration pushes Yuko review events into Klaviyo as Events with a rich set of event properties. Use those events to build flows, segments, and campaigns triggered by review activity.

Events sent to Klaviyo

When a review-related action happens in Yuko, the matching event is sent to Klaviyo with the customer’s email as the profile identifier.

Event ID	Display name	Fires when
`order_review_request`	Review Request	A review request is triggered for an order
`review_request_sent`	Review Request Sent	A review request email is delivered
`review_submitted`	Review Submitted	A customer submits a review
`review_approved`	Review Published	A review reaches Published status
`review_reply_added`	Review Reply Added	You post a merchant reply to a review
`review_deleted`	Review Deleted	A review is deleted or removed
`question_submitted`	Question Submitted	A customer submits a question
`question_published`	Question Published	A customer question reaches the Published status

Event properties

Each review event carries the fields below, so you can filter Klaviyo flows and segments on them:

Common Event Properties

Every review-related event Yuko sends to Klaviyo carries the following properties, in addition to the event-specific properties documented per event.

Property	Type	Description
`yuko_customer_email`	String	Customer email (matches Klaviyo profile)
`yuko_customer_first_name`	String	Customer first name
`yuko_customer_last_name`	String	Customer last name
`yuko_shopify_customer_id`	String	The Shopify customer ID this event relates to
`yuko_program_module`	String	Active Yuko module for this event
`yuko_program_currency`	String	Customer’s currency code
`yuko_timestamp`	ISO	When the event was triggered in Yuko
`yuko_org_uuid`	String	Yuko organisation UUID

Yuko Review Request

Klaviyo metric: Yuko Review Request
Event slug: review_request
When it fires: A review request for a customer generated

Property	Type	Description
`yuko_review_uuid`	String	Unique identifier for the review
`yuko_store_review_url`	String	URL to the store’s review page
`yuko_review_url`	String	Direct URL to the product review form
`yuko_review_urls`	Array (JSON)	Array of product review URL objects with metadata
`yuko_platform_product_id`	String	Shopify / platform product ID
`yuko_platform_order_id`	String	Shopify / platform order ID that triggered the request
`yuko_platform_variation_id`	String	Product variant ID (empty if not applicable)
`yuko_product_name`	String	Name of the product being reviewed
`yuko_rating`	Integer	Star rating submitted by the customer (1–5)
`yuko_review_title`	String	Title of the review
`yuko_review_content`	String	Body text of the review
`yuko_status`	String	Review moderation status
`yuko_is_verified`	Boolean	Whether the reviewer is a verified purchaser
`yuko_has_media`	Boolean	Whether the review contains any media (photo or video)
`yuko_has_photos`	Boolean	Whether the review contains photos
`yuko_has_videos`	Boolean	Whether the review contains videos
`yuko_review_parent_uuid`	String	UUID of the parent review (for reply reviews; empty otherwise)
`yuko_email`	String	Store notification email address
`yuko_created_at`	ISO 8601 string	When the review record was created in Yuko
`yuko_deleted_at`	ISO 8601 string	When the review was deleted (empty if not deleted)