Magento order review invitation API pattern: webhooks to the ask
How Adobe Commerce order events feed a review invitation API, then moderation and display. For Magento teams who already know the UGC app list. We make Idukki.
A Magento order sits in Admin with a paid status and a shipped date. The review ask never leaves the warehouse. The product page still shows three old text reviews. What you need is a path from that order event to one invitation.
In this article
We make Idukki. This guide is the wiring pattern for Magento and Adobe Commerce. It is not another list of UGC apps. For Marketplace options, see best UGC apps for Magento.
Why webhooks beat a nightly CSV
A CSV export of yesterday’s orders arrives late. A buyer already forgot the unboxing. Adobe Commerce Webhooks and Magento observers fire when the order changes. That is the right moment to schedule an ask.
You still need a delay. Ask on “created” and the parcel is still in transit. Ask on “complete” or “shipped”, then wait a few days. The invitation API holds that delay.
Nightly CSV against an order webhook
Nightly CSV
- Yesterday’s orders arrive a day late
- The buyer has forgotten the unboxing
- Mixed statuses can double-send
Order webhook
- Fires when the order changes
- One status starts the delay timer
- The order id blocks a second send
The five-step pattern
From Magento order to live review
- 01
Order event
Webhook or observer fires on complete or shipped.
- 02
Normalise
Map Magento product and customer ids to the invitation payload.
- 03
Invite
Call the invitation API with delay, locale and product lines.
- 04
Collect
Buyer rates, writes, and can add photos or a video.
- 05
Show
Approved reviews feed the PDP widget and any UGC gallery.
What the invitation API needs
| Field | Why it matters |
|---|---|
| Order id | Dedupes invites and ties the review to a purchase |
| Buyer email | Where the invite goes |
| Product ids / SKUs | Stars land on the right PDP |
| Locale / store view | Language and currency of the ask |
| Shipped or complete time | Starts the delay timer |
Do not send billing address into the invitation call. Email, order id and line items are enough for a product review ask.
Three Magento shapes that work
- Adobe Commerce Webhooks. Point a subscribed event at your invitation endpoint or a thin middleware.
- Custom observer. On status change, enqueue a job that calls the invitation API.
- Module order feed. A store module posts orders to your reviews or UGC platform, which schedules the ask.
Idukki’s Magento 2 module posts each order with the gallery visitor id. It is early access and not on the Marketplace. Catalogue sync and CMS galleries ride the same module. See the Magento setup.
Idukki’s automated review request email runs on Shopify order and fulfilment webhooks today. On Magento, treat the invitation send as your ESP or reviews tool until that path ships.
Moderation and display after the ask
Collection without moderation puts raw media on the PDP. Keep one queue for review text, photos and social posts. Approve once. Publish to stars and to a gallery near the buy button.
Photo reviews belong higher than the classic stars band. A UGC gallery can sit near the add-to-cart block while the stars widget keeps the text.
Checks before you go live
- 1Fire a test order through complete or shipped and confirm one invite.
- 2Retry the webhook and confirm the idempotency key blocks a second send.
- 3Submit a photo review and confirm it waits in moderation.
- 4Approve it and open the PDP on the matching store view.
- 5Confirm cancelled orders never schedule an invite.
Questions Magento teams ask
Should the invite fire on order create?
Usually no. Wait for shipped or complete. Then add a delay of a few days so the product is in hand.
Can one webhook serve several store views?
Yes, if the payload includes store view or locale. Route the invite language from that field.
Does Idukki send Magento review emails today?
No. Automated review request email is Shopify-only. Magento orders can still reach Idukki through the early-access module.
Where do photo reviews show?
In the review layouts and in the same library as social UGC, once approved. See /reviews.
Sources and related reading
- 1Idukki reviews · Order-tied collection, photo and video form, moderation.
- 2Idukki Magento / Adobe Commerce · Module early access: galleries, catalogue, orders.
- 3Best UGC apps for Magento and Adobe Commerce · Marketplace options; this piece covers the invitation pattern instead.
- 4Adobe Commerce Webhooks (Adobe docs) · Vendor docs for order and other events.
Continue reading
2 pieces in this clusterThese long-form pieces on the Idukki blog link back to this article, go deeper on the cluster.
- Buyer's guides
Reviews.io-style collection without the suite: invites, moderate, show
You need review invitations, moderation and on-site display. You may not need loyalty and SMS in the same contract. How to buy the collection layer. We make Idukki.
- Reviews and ratings
One reviews stack for two storefronts: shared queue, separate widgets
Share one moderation queue across two brands or markets. Keep separate review and UGC widgets per storefront. Architecture table and checks. We make Idukki.
More from Rohin Aggarwal
- Reviews and ratings
Headless product reviews via API: invite queue to widget
Run product reviews on a headless storefront. Invite queue, submit and media upload, PDP aggregates, mount options, auth and webhooks. We make Idukki.
- Industry playbook
UGC & Shoppable Video on Magento / Adobe Commerce
A no-code embed or a thin API integration puts shoppable UGC and video on Magento or Adobe Commerce, handling multi-store, multi-locale, performance and rights.
- Buyer's guides
Reviews.io-style collection without the suite: invites, moderate, show
You need review invitations, moderation and on-site display. You may not need loyalty and SMS in the same contract. How to buy the collection layer. We make Idukki.