# product-review.replied > Sent when your team posts or edits a reply to a product review, with the review, the reviewer's profile and their loyalty standing. Breadcrumb: Webhooks › product-review.replied · Status: Flow only · Updated: 2026-11-04 Docs index: https://docs.cevoid.com/developers/llms.txt Use it to keep a copy of your replies next to the review in another system. ## When it fires - When a reply to a product review is posted or edited, public or private. - The body does not say which reply changed, or whether it was posted or edited. `data.product_review.responses` lists the public replies; private replies are never included. ## Receive it Only a Flow sends this event: it cannot be picked on a destination. Send it from a Flow on the _Product review replied_ trigger. See [Send from a Flow](https://docs.cevoid.com/developers/webhooks/set-up.md#send-from-a-flow). ## Payload ```json title="Example payload" { "created_at": "2026-11-02T09:30:00.000Z", "data": { "points": { "expiring_30d": 400, "expiring_60d": 650, "expiring_90d": 750, "lifetime_earned": 5400, "lifetime_spent": 4150, "next_expiration_at": "2026-12-31T00:00:00.000Z", "pending": 100, "spendable": 1150, "total": 1250 }, "product_review": { "answers": [ { "format": "CENTERED_RANGE", "prompt": "How does it fit?", "scale": { "center_label": "Just right", "end_label": "Too large", "start_label": "Too small", "steps": 5 }, "type": "PRODUCT_ATTRIBUTE", "value": 3 }, { "format": "SINGLE_SELECT", "options": [ { "label": "Blue", "value": "blue" }, { "label": "Green", "value": "green" } ], "prompt": "What is your favourite colour?", "type": "PROFILE_PROPERTY", "value": "blue" } ], "approved_at": "2026-09-01T10:00:00.000Z", "body": "Comfortable and true to size.", "channel": "REQUEST", "created_at": "2026-09-01T10:00:00.000Z", "helpful_down_count": 0, "helpful_up_count": 3, "id": "rev_abc123", "identity_verification": "CONFIRMED", "is_incentivized": false, "is_insider": false, "language": "en", "market_id": "mar_abc123", "media": [ { "aspect_ratio": 1.5, "aspect_ratio_type": "LANDSCAPE", "moderation_status": "APPROVED", "thumbnail_url": "https://cdn.cevoid.com/reviews/rev_abc123/photo-thumb.jpg", "type": "IMAGE", "url": "https://cdn.cevoid.com/reviews/rev_abc123/photo.jpg" }, { "aspect_ratio": 0.5625, "aspect_ratio_type": "PORTRAIT", "thumbnail_url": "https://cdn.cevoid.com/reviews/rev_abc123/clip-thumb.jpg", "type": "VIDEO", "url": "https://cdn.cevoid.com/reviews/rev_abc123/clip.mp4", "video_length": 12 } ], "order_id": "ord_abc123", "pinned_at": "2026-09-01T10:00:00.000Z", "product": { "id": "prd_abc123", "image_url": "https://cdn.example.com/products/everyday-shirt.jpg", "options": [ "color:blue", "size:m" ], "price": { "amount": 49.95, "currency": "USD" }, "sku": "SHIRT-BLUE-M", "title": "Everyday shirt", "variant_id": "var_abc123" }, "profile_id": "prf_abc123", "published_at": "2026-09-01T10:00:00.000Z", "purchase_verification": "VERIFIED", "rating": 5, "rejection_reasons": [], "responses": [ { "author_type": "WORKSPACE", "body": "Thank you for the kind words!", "created_at": "2026-09-01T10:00:00.000Z", "updated_at": "2026-09-01T10:00:00.000Z" } ], "source": { "external_id": "review_123", "platform": "cevoid", "url": "https://example.com/reviews/123" }, "status": "PUBLISHED", "submitted_at": "2026-09-01T10:00:00.000Z", "title": "Comfortable everyday fit", "updated_at": "2026-09-01T10:00:00.000Z" }, "profile": { "avatar_url": "https://cdn.cevoid.com/avatars/prf_sarah/profile.jpg", "bio": "Lifestyle creator and photography enthusiast", "birthday": "1992-04-18", "country": "US", "created_at": "2026-01-15T09:30:00.000Z", "email": "sarah.johnson@example.com", "external_id": "customer_7391056823401", "first_name": "Sarah", "id": "prf_sarah", "language": "en", "last_name": "Johnson", "location": "San Francisco, CA", "name": "Sarah Johnson", "notes": "VIP customer; prefers email communication", "social_instagram_handle": "sarah.lifestyle", "social_tiktok_handle": "sarah.creates", "social_x_handle": "sarah_j", "updated_at": "2026-01-20T14:22:15.000Z" }, "tier": { "current_tier": { "expires_at": "2026-12-31T23:59:59.999Z", "icon_url": "https://cdn.cevoid.com/tiers/silver.png", "id": "tier_silver", "name": "Silver" }, "next_tier": { "entry_rewards": [ { "icon_url": "https://cdn.cevoid.com/rewards/reward-icon.png", "title": "10% Off Reward", "type": "DISCOUNT_CODE" } ], "icon_url": "https://cdn.cevoid.com/tiers/gold.png", "id": "tier_gold", "milestones": [ { "current": 750, "percent_complete": 75, "remaining": 250, "required": 1000, "type": "POINTS" } ], "name": "Gold", "perks": [ { "value": "Exclusive early access to launches" } ] } } }, "id": "evt_m3p82kdq5xw7tz4c", "origin": { "flow": { "id": "wfl_q7v2m9x4k8d3h6b5", "name": "Post-purchase follow-up" }, "trigger": "product-review.replied" }, "type": "product-review.replied", "version": 1 } ``` - `version` (`number`, required): The version of this event type. A published version only gains fields, so ignore fields you do not use; a breaking change is a new version. - `id` (`string`, required): Stable event id (`evt_` plus 16 characters), also sent as the `webhook-id` header. Retries and manual replays send the same id, so ignore an event whose id you have already processed. - `type` (`string`, required): What `data` describes. New types are added over time, and an endpoint on "All events" receives them, so ignore any type you do not handle. - `created_at` (`string`, required): When the event happened, as an ISO 8601 timestamp. - `origin` (`object`): Why your endpoint received the event. Omitted when the event was forwarded without a Flow of your own. - `origin.flow` (`object`, required): The Flow that sent the event. - `origin.flow.id` (`string`, required): The Flow id, shown in the Flow URL. - `origin.flow.name` (`string`, required): The Flow name at the time of sending. - `origin.trigger` (`string`, required): The event that started the Flow. One of `order.fulfilled`, `order.delivered`, `product-review.submitted`, `company-review.submitted`, `product-review.replied`, `company-review.replied`, `upload.completed`, `post.approved`, `profile.program-joined`, `profile.program-left`, `tier.earned`, `reward.fulfilled`, `tier.evaluation-approaching`, `points.expiration-approaching`. - `data` (`object`, required): The resources the event carries, keyed by resource name. `type` decides which resources are included, and resources your plan does not include are left out. - `data.product_review` (`object`) - `data.product_review.id` (`string`, required): Cevoid public product review identifier. - `data.product_review.rating` (`integer`, required): Score from 1 to 5. - `data.product_review.title` (`string`): Reviewer-supplied headline. In localized responses, title and body both use source text unless a complete translation is available. - `data.product_review.body` (`string`): Reviewer-supplied text. Absent for star-only reviews. In localized responses, title and body both use source text unless a complete translation is available. - `data.product_review.language` (`string`, required): BCP-47 language of the original submission, even when the returned text is translated. - `data.product_review.status` (`string`, required): Moderation and conversion state. One of `PENDING`, `PUBLISHED`, `REJECTED`, `CONVERTED`. - `data.product_review.rejection_reasons` (`string[]`, required): Policy reasons recorded when moderation rejected the review. Empty unless status is REJECTED; a single take-down can carry several. Each item is one of `SPAM`, `FAKE`, `DUPLICATE`, `OFF_TOPIC`, `PROFANE`, `ILLEGAL`, `PII`. - `data.product_review.identity_verification` (`string`, required): Author verification state. Public display requires CONFIRMED. One of `PENDING`, `CONFIRMED`, `EXPIRED`. - `data.product_review.purchase_verification` (`string`, required): Purchase evidence state behind verified-buyer display. One of `VERIFIED`, `UNVERIFIED`. - `data.product_review.is_incentivized` (`boolean`, required): Whether a reward influenced submission. - `data.product_review.is_insider` (`boolean`, required): Whether the reviewer is brand-connected. - `data.product_review.channel` (`string`, required): How the review entered Cevoid. One of `REQUEST`, `WIDGET`, `LINK`, `IMPORT`, `SYNDICATED_IN`. - `data.product_review.source` (`object`): External provenance. Present for imported or syndicated reviews. - `data.product_review.source.platform` (`string`, required): Source-system slug, such as okendo or yotpo. - `data.product_review.source.external_id` (`string`): Review identifier in the source system. - `data.product_review.source.url` (`string`): Link to the review in its source system. - `data.product_review.profile_id` (`string`, required): Cevoid public identifier of the reviewer. - `data.product_review.market_id` (`string`): Cevoid public market identifier. - `data.product_review.order_id` (`string`): Cevoid public identifier of the matched order. - `data.product_review.reward_id` (`string`): Granted reward, when the review was incentivized. - `data.product_review.converted_from_id` (`string`): Review this one was converted from. - `data.product_review.converted_to_id` (`string`): Replacement review created by conversion. - `data.product_review.media` (`object[]`, required) - `data.product_review.media[].type` (`string`, required): Whether the item is an image or a video. One of `IMAGE`, `VIDEO`. - `data.product_review.media[].url` (`string`, required): Delivery URL for the full asset. - `data.product_review.media[].thumbnail_url` (`string`, required): Delivery URL for the thumbnail. - `data.product_review.media[].aspect_ratio` (`number`, required): Width divided by height. - `data.product_review.media[].aspect_ratio_type` (`string`, required): Coarse orientation bucket. One of `LANDSCAPE`, `PORTRAIT`, `SQUARE`. - `data.product_review.media[].video_length` (`number`): Video duration in seconds. - `data.product_review.media[].moderation_status` (`string`): Moderation state for this asset, independent from the review itself. One of `PENDING`, `APPROVED`, `DECLINED`. - `data.product_review.responses` (`object[]`, required): Public workspace replies. Private replies are never exposed. - `data.product_review.responses[].body` (`string`, required): Reply text as published. - `data.product_review.responses[].author_type` (`string`, required): Whether the workspace or a named team member authored the reply. One of `WORKSPACE`, `TEAM_MEMBER`. - `data.product_review.responses[].created_at` (`string`, required): ISO 8601 timestamp when the reply was created. - `data.product_review.responses[].updated_at` (`string`): ISO 8601 timestamp when the reply was last edited. - `data.product_review.helpful_up_count` (`number`, required): Positive helpful votes from shoppers. - `data.product_review.helpful_down_count` (`number`, required): Negative helpful votes, when down-voting is enabled. - `data.product_review.submitted_at` (`string`): ISO 8601 timestamp when submission completed. - `data.product_review.approved_at` (`string`): ISO 8601 timestamp when moderation approved it. - `data.product_review.published_at` (`string`): ISO 8601 timestamp when it first became public. - `data.product_review.created_at` (`string`, required): ISO 8601 timestamp when Cevoid created the review. - `data.product_review.updated_at` (`string`, required): ISO 8601 timestamp when Cevoid last updated the review. - `data.product_review.answers` (`object[]`, required) - `data.product_review.answers[].type` (`string`, required): What the question was about. One of `PRODUCT_ATTRIBUTE`, `PROFILE_PROPERTY`. - `data.product_review.answers[].prompt` (`string`, required): Question wording as shown at submission time. - `data.product_review.answers[].format` (`string`, required): Input shape used to interpret `value`. One of `SCALE`, `CENTERED_RANGE`, `SINGLE_SELECT`, `MULTI_SELECT`, `WOULD_RECOMMEND`, `NUMERIC`. - `data.product_review.answers[].options` (`object[]`): Options as shown at submission time. - `data.product_review.answers[].options[].value` (`string`, required) - `data.product_review.answers[].options[].label` (`string`, required) - `data.product_review.answers[].scale` (`object`): Scale definition as shown at submission time. - `data.product_review.answers[].scale.steps` (`number`, required) - `data.product_review.answers[].scale.start_label` (`string`, required) - `data.product_review.answers[].scale.end_label` (`string`, required) - `data.product_review.answers[].scale.center_label` (`string`) - `data.product_review.answers[].scale.step_labels` (`string[]`) - `data.product_review.answers[].value` (`number | string | boolean | string[]`, required): Submitted scalar or selection, interpreted per `format`. - `data.product_review.product` (`object`, required): Immutable product presentation captured at submission, so the review stays renderable after the product changes or is delisted. - `data.product_review.product.id` (`string`): Cevoid public catalog product identifier. - `data.product_review.product.variant_id` (`string`): Cevoid public catalog variant identifier. - `data.product_review.product.title` (`string`): Product title as at submission. - `data.product_review.product.image_url` (`string`): Product image as at submission. - `data.product_review.product.sku` (`string`): Merchant SKU as at submission. - `data.product_review.product.price` (`object`): Price as at submission. - `data.product_review.product.price.amount` (`number`, required) - `data.product_review.product.price.currency` (`string`, required) - `data.product_review.product.options` (`string[]`): Flattened variant options at submission, e.g. ["color:blue"]. - `data.product_review.pinned_at` (`string`): ISO 8601 timestamp when pinned to its product. - `data.profile` (`object`) - `data.profile.id` (`string`, required): Cevoid profile ID. - `data.profile.external_id` (`string`): Identifier this profile carries in the workspace source system, when known. - `data.profile.name` (`string`): Display name of the profile. - `data.profile.first_name` (`string`): First name of the profile. - `data.profile.last_name` (`string`): Last name of the profile. - `data.profile.email` (`string`): Email address for the profile. - `data.profile.avatar_url` (`string`): Profile image URL. - `data.profile.country` (`string`): Country code associated with the profile. - `data.profile.language` (`string`): Preferred language code associated with the profile. - `data.profile.location` (`string`): Free-form location associated with the profile. - `data.profile.social_instagram_handle` (`string`): Instagram handle associated with the profile. - `data.profile.social_tiktok_handle` (`string`): TikTok handle associated with the profile. - `data.profile.social_x_handle` (`string`): X handle associated with the profile. - `data.profile.birthday` (`string`): Birthday in YYYY-MM-DD format. - `data.profile.bio` (`string`): Profile biography text. - `data.profile.notes` (`string`): Merchant notes about the profile. - `data.profile.created_at` (`string`, required): ISO 8601 timestamp when the profile was created. - `data.profile.updated_at` (`string`, required): ISO 8601 timestamp when the profile was last updated. - `data.points` (`object`) - `data.points.total` (`number`, required): Total active and pending points. - `data.points.spendable` (`number`, required): Active points available to spend. - `data.points.pending` (`number`, required): Earned points not active yet. - `data.points.expiring_30d` (`number`, required): Points expiring within 30 days. - `data.points.expiring_60d` (`number`, required): Points expiring within 60 days. - `data.points.expiring_90d` (`number`, required): Points expiring within 90 days. - `data.points.lifetime_earned` (`number`, required): Points earned over the membership lifetime. - `data.points.lifetime_spent` (`number`, required): Points spent over the membership lifetime. - `data.points.next_expiration_at` (`string`): Earliest upcoming active-points expiration. - `data.tier` (`object`) - `data.tier.current_tier` (`object | null`, required): Current tier, or null. - `data.tier.current_tier.id` (`string`, required): Cevoid tier ID. - `data.tier.current_tier.name` (`string`, required): Display name of the tier. - `data.tier.current_tier.icon_url` (`string`): Optional icon representing the tier. - `data.tier.current_tier.expires_at` (`string`): When the current tier expires, if tier evaluations expire. - `data.tier.next_tier` (`object | null`, required): Next reachable tier, or null. - `data.tier.next_tier.id` (`string`, required): Cevoid tier ID. - `data.tier.next_tier.name` (`string`, required): Display name of the tier. - `data.tier.next_tier.icon_url` (`string`): Optional icon representing the tier. - `data.tier.next_tier.milestones` (`object[]`, required): Progress required for the next tier. - `data.tier.next_tier.milestones[].type` (`string`, required): Metric used to qualify for the next tier. One of `POINTS`, `AMOUNT_SPENT`, `NUMBER_OF_PURCHASES`. - `data.tier.next_tier.milestones[].required` (`number`, required): Required amount for the next tier. AMOUNT_SPENT values use major currency units. - `data.tier.next_tier.milestones[].current` (`number`, required): Current progress. AMOUNT_SPENT values use major currency units. - `data.tier.next_tier.milestones[].remaining` (`number`, required): Remaining amount. AMOUNT_SPENT values use major currency units. - `data.tier.next_tier.milestones[].percent_complete` (`number`, required): Progress percentage, capped at 100. - `data.tier.next_tier.entry_rewards` (`object[]`, required): Rewards granted at the next tier. - `data.tier.next_tier.entry_rewards[].type` (`string`, required): Reward type granted when the tier is reached. - `data.tier.next_tier.entry_rewards[].title` (`string`, required): Human-readable reward title. - `data.tier.next_tier.entry_rewards[].icon_url` (`string`): Optional icon representing the reward. - `data.tier.next_tier.perks` (`object[]`, required): Perks associated with the next tier. - `data.tier.next_tier.perks[].value` (`string`, required): Human-readable perk text. ## Related articles - [product-review.submitted](https://docs.cevoid.com/developers/webhooks/product-review-submitted.md) - [Event types](https://docs.cevoid.com/developers/webhooks/event-types.md) --- Canonical: https://docs.cevoid.com/developers/webhooks/product-review-replied