開発者向けの変更です。
Amazon EventBridge で受け取る webhook と Events のペイロードの上限が、256KBから1MBに上がりました。
上限は256KBから1MBに上がりました
Amazon EventBridge 経由で届くペイロードは、最大1MBまでになりました。
発表は2026年11月17日の developer changelog です。
出典: Shopify developer changelog「Amazon EventBridge webhook payload size limit increased to 1 MB」2026年11月17日
https://shopify.dev/changelog/posts/amazon-eventbridge-webhook-payload-size-limit-increased-to-1-mb
You can now receive webhook and Events payloads up to 1 MB (1,000,000 bytes) through Amazon EventBridge, up from 256 KB. This increase applies automatically across all API versions, and you don’t need to update your existing subscriptions.
(Amazon EventBridge を通じて、webhook と Events のペイロードを最大1MB=1,000,000バイトまで受け取れるようになりました。以前は256KBでした。この引き上げは全ての API バージョンに自動で当てはまり、既存の購読を更新する必要はありません)
- フラグは「Update」
- タグは「Events & webhooks」
- 対象は、全ての API バージョン
これまでは256KBを超えると本文がそのまま届きませんでした
以前は、256KBを超えるペイロードは別の形に置き換わっていました。
Classic webhook payloads over 256 KB fell back to a minimal {“id”: …} body, requiring a follow-up Admin API request to fetch the full resource.
Events payloads over 256 KB used large-payload overflow and delivered a temporary payload_url download link instead of the inline payload.
(256KBを超える従来の webhook のペイロードは、最小限の {“id”: …} の本文に切り替わり、全体を取るには Admin API への追加のリクエストが要りました。256KBを超える Events のペイロードは、本文の代わりに一時的なダウンロード用リンク payload_url を届けていました)
従来の webhook で届くのは、{"id": ...} だけの本文。
アプリは、その ID で Admin API にもう一度問い合わせる必要がありました。
Events では、本文の代わりに一時的なリンク payload_url が届く形。
大きな商品や注文がそのまま届くようになります
今回の変更で、1,000,000バイトまでのペイロードは本文ごと届きます。
Large resources such as products with many variants or orders with many line items now arrive inline, reducing follow-up Admin API requests and payload_url downloads in your app.
(バリエーションの多い商品や、明細の多い注文のような大きなリソースが本文のまま届くようになり、アプリでの Admin API への追加のリクエストと payload_url のダウンロードが減ります)
例に挙がっているのは、バリエーションの多い商品と、明細の多い注文の2つ。
Shopify が送るのは、UTF-8 のままのペイロードです。
EventBridge には、1件あたり1MiBの上限があります。
1,000,000バイトはその中に枠の余白を残す値だと、原文は書いています。
余白に入るのは、source・detail-type・detail の枠。
1MBを超えたときの扱いは今までと同じです
1,000,000バイトを超えるペイロードは、これまでの代わりの形で届きます。
Payloads over 1,000,000 bytes keep the existing fallback behavior: classic webhooks send {“id”: …}, and Events deliveries send a stub payload with payload_url, payload_size_bytes, and expires_at.
(1,000,000バイトを超えるペイロードは、既存の代わりの動きのままです。従来の webhook は {“id”: …} を送り、Events の配信は payload_url・payload_size_bytes・expires_at を含む仮のペイロードを送ります)
- 従来の webhook は
{"id": ...}を送ります - Events は
payload_url・payload_size_bytes・expires_atを含む仮のペイロード
既存の購読はそのままで対応は要りません
公式は、対応は不要と明記しています。
No action is required. Existing EventBridge subscriptions configured in shopify.app.toml or through the GraphQL Admin API (eventBridgeWebhookSubscriptionCreate and webhookSubscriptionCreate) automatically receive inline payloads up to 1 MB across all API versions.
(対応は不要です。shopify.app.toml か GraphQL Admin API の eventBridgeWebhookSubscriptionCreate・webhookSubscriptionCreate で設定した既存の EventBridge の購読は、全ての API バージョンで、最大1MBの本文をそのまま自動で受け取ります)
shopify.app.toml で設定した購読も、GraphQL Admin API で作った購読も対象。
API の名前は eventBridgeWebhookSubscriptionCreate と webhookSubscriptionCreate です。
見直すときの点は2つです
公式は、大きな配信の扱いを見直すための点を2つ挙げています。
Keep fallback handling in place for payloads that exceed 1 MB ({“id”: …} for classic webhooks and payload_url for Events), or narrow payloads with include_fields and targeted Events [events.subscription] query selections.
Verify that the downstream AWS targets attached to your EventBridge rules accept events up to 1 MB, or configure an EventBridge input transformer if a target enforces a smaller quota.
(1MBを超えるペイロードのための代わりの処理は残してください。従来の webhook では {“id”: …}、Events では payload_url です。または include_fields や、Events の [events.subscription] のクエリの選択でペイロードを絞ってください。EventBridge のルールにつながる下流の AWS のターゲットが1MBまでのイベントを受け付けるかを見てください。小さい上限のターゲットには、EventBridge の input transformer を設定してください)
- 1つ目は、1MBを超えたときの代わりの処理を消さないこと。または、ペイロードを絞ること
- 2つ目は、EventBridge の先につながる AWS 側の受け口が1MBを受け付けるかという点
受け口の上限が小さいときの手として、公式は input transformer を挙げています。
🔴 公式に書かれていないこと
次の点は、一次ソースにありません。
- 変更がいつから効いているかの日時は書かれていません。原文は「now」とだけ書きます
- Amazon EventBridge 以外の配信先の上限が変わるかは書かれていません。この発表は EventBridge だけの話です
- 下流の AWS のターゲットごとの上限の値は書かれていません
- 店の側で何か操作が要るかは書かれていません。対象として書かれているのはアプリです
- 🔴 本記事は EventBridge の購読を作って試していません。記載が無いことをもって「できる」とも「できない」とも書きません
開発者と店がやることを整理します
開発者がやることは次の3つです。
- 1MBを超えたときの代わりの処理を残す。
{"id": ...}とpayload_urlの両方。または、include_fieldsと Events の[events.subscription]の query の選択でペイロードを絞る - EventBridge のルールの先の AWS のターゲットが1MBまで受けるかを見る
- 小さい上限のターゲットには EventBridge の input transformer を設定する
店向けの手順は、今回の発表に出てきません。
🔵 上の手順はキクシル編集部の整理で、公式の記載ではありません。
出典
- Shopify developer changelog「Amazon EventBridge webhook payload size limit increased to 1 MB」2026年11月17日
https://shopify.dev/changelog/posts/amazon-eventbridge-webhook-payload-size-limit-increased-to-1-mb
上記の Shopify 公式の情報だけを一次情報として使っています。

