Shopify Events GA: start a Sume product video from the payload query
Shopify's Next Gen Events are GA in API version 2026-10 with 18 topics and a query in the payload. One delivery can start a Sume job without a follow-up fetch.

With Shopify's Next Gen Events, now generally available in API version 2026-10, one delivery can carry everything a Sume submit needs, so your handler can start one product-video job without first calling the Admin API. Shopify says Events means fewer deliveries, richer payloads and no follow-up queries, with subscriptions declared in shopify.app.toml as triggers, a GraphQL query and an optional query filter.
The Shopify facts are from its GA announcement and the earlier payloads notice; the Sume side is from Jobs and results and Generation admission, all read 2026-10-03. I did not run a subscription.
What does Shopify say is new?
Events is described as a declarative replacement for classic webhooks, generally available across 18 topics covering merchandising, orders, inventory, content management and custom data types. Existing webhook integrations keep working, and you can migrate gradually or run both.
| Events piece | What it does | Sume piece |
|---|---|---|
| Trigger | Picks the change to react to | Starts one submit |
| Query | Returns the fields you ask for in the payload | Fills the prompt or input fields |
| Query filter | Limits deliveries to matching results | Keeps paid jobs to the products you want |
| Delivery | One delivery per match | One Idempotency-Key per delivery |
What should the handler do with a delivery?
Authenticate the delivery the way Shopify documents (not covered in the pages I read), store it, derive an Idempotency-Key from the resource and the Sume request body, and submit with mode: "webhook" or async. Do not rely on Shopify's removed delivery headers for the key. Then let Sume tell you: a job webhook is terminal-only, with job.completed, job.failed or job.canceled, and you should keep status_url polling as the backup.
Pace the submits. Sume accepts valid jobs as queued while queue capacity remains and answers 429 queue_full when it does not, so a bulk catalog change that matches many products can fill the queue; check generation_limits.queue_capacity_remaining and stop adding work when it is low.
Sources
Related posts
More in Integrations
- Shopify's video limit by plan: 250 to 100,000 files, what to keep
Shopify counts video and 3D files per store by plan: 250 on Starter up to 100,000 on Enterprise. How to decide which product clips are worth keeping.
- Shopify video_tag loop: no HLS, so keep the product clip short
Shopify's video_tag skips the HLS source when loop is on, so the MP4 downloads whole. How to cut a short looping clip and conform its size with Sume video trim.
- Shopify Winter '26 shoppable video in Shop: prepare your clips
Shopify's Winter '26 Edition adds shoppable video in Shop with AI ranking. How to prepare clips that fit Shopify's file limits, with Sume doing the cuts.
- Square Online video section: 100 MB, one hour, loop and autoplay
Square Online's Video section takes your own file up to 100 MB and one hour, with loop and automatic playback. How to cut and size a product clip for it.
Written by Sume