WEBHOOKS

Amazon EventBridge Webhookペイロード上限が1MBに拡大

256KB制限を撤廃、大型リソースのインライン受信で二次APIコールを削減

ShopifyWebhook / Eventsペイロード生成上限: 256KB → 1MB自動適用・変更不要Amazon EventBridgeインラインで受信AWSターゲットへ転送

Amazon EventBridge経由のWebhook・Eventsペイロード上限が256KBから1MB(1,000,000バイト)に引き上げられました。2026年11月17日より全APIバージョンに自動適用され、既存のサブスクリプション設定変更は一切不要です。バリアント数の多い商品や明細行の多い注文などの大型リソースがインラインで届くようになり、Admin APIへの二次取得リクエストが削減されます。

1変更前後の比較

Before (256KB上限) vs After (1MB上限)■ Before: 上限 256 KBClassic Webhook256KB超 → {"id":...} のみ送信→ Admin APIで再取得が必要Events (大ペイロード)256KB超 → payload_url を送信→ 一時URLからダウンロード必要二次リクエスト必須 → レイテンシ増・コスト増■ After: 上限 1 MB (1,000,000 bytes)Classic Webhook1MB以内 → フルペイロードをインライン送信→ 二次取得不要Events1MB以内 → インラインで直接受信→ payload_url ダウンロード不要1MB超のみ従来フォールバック動作を維持

1MB(1,000,000バイト)を超えるペイロードは引き続き従来のフォールバック動作(Classicは{"id":...}、Eventsはpayload_url付きスタブ)となります。

2業務に活かせる具体ユースケース

課題
バリアントが数十種類ある商品マスタの同期で、products/update Webhookが256KB超となり毎回{"id":...}のみ受信。Admin APIへの再取得でレイテンシが増加していた。
打ち手
EventBridgeサブスクリプションはそのままで、1MB以内の商品ペイロードが自動でインライン受信されるようになる。
効果
Admin APIへの二次リクエストが削減されリアルタイム性が向上。在庫・価格同期のタイムラグを短縮できる。
技術メモ
バリアント数が非常に多い場合(1MB超の可能性)はinclude_fieldsで必要フィールドを絞り込む対応を検討。
課題
明細行が多い大口注文のorders/create Webhookでpayload_urlが届き、一時URLへの追加ダウンロード処理が必要だった。URLの有効期限切れによるデータ欠損リスクもあった。
打ち手
1MB以内の注文ペイロードは自動でインラインに切り替わる。payload_url対応ロジックは残しつつ、通常フローはシンプル化できる。
効果
注文処理パイプラインのエラーポイントが減少し、WMSや基幹システムとの連携安定性が向上する。
技術メモ
AWS Lambda等のダウンストリームターゲットが1MB受け入れ可能か事前に確認。必要に応じてEventBridge Input Transformerで絞り込む。
課題
Eventsサブスクリプションで大量の行を含むfulfillmentイベントがpayload_urlで届き、処理ロジックが複雑化していた。
打ち手
1MB以内のEventsペイロードはインライン受信に変わるため、payload_urlダウンロード分岐が不要になるケースが増える。
効果
フルフィルメント状態の即時反映が可能になり、顧客向けステータス通知の遅延を解消できる。
技術メモ
Events subscriptionの[events.subscription]クエリセレクションを活用して取得フィールドを限定することでペイロードサイズを管理可能。

3技術者目線のポイント

観点 詳細
適用範囲 全APIバージョンに自動適用。shopify.app.toml設定・GraphQL Admin API(eventBridgeWebhookSubscriptionCreate / webhookSubscriptionCreate)どちらのサブスクリプションも対象。変更作業不要。
サイズ定義 上限は1,000,000バイト(UTF-8 raw)。EventBridgeの1MiB(1,048,576バイト)エントリキャップより小さく設定されており、source・detail-type・detailエンベロープのオーバーヘッド分を考慮済み。
フォールバック動作 1,000,000バイト超のペイロードは従来通り:Classicは{"id":...}のみ、Eventsはpayload_url・payload_size_bytes・expires_atを含むスタブ送信。フォールバック処理コードは削除しないこと。
ペイロード絞り込み 大型リソースでも1MB超を避けたい場合はinclude_fields(Classic Webhook)またはEvents[events.subscription]のクエリセレクションで必要フィールドのみ取得するよう設計する。
AWSターゲット確認 EventBridgeに接続しているLambda・SQS・Kinesis等のターゲットが1MBのイベントを受け入れられるか確認が必要。受け入れ不可の場合はEventBridge Input Transformerで変換・絞り込みを実施する。

4対応チェックリスト

不要

既存サブスクリプションの変更
設定ファイル・APIコールとも修正不要。自動適用されます。

推奨確認

フォールバック処理の維持
{"id":...}・payload_url対応ロジックは1MB超ケースに引き続き必要です。

推奨確認

AWSダウンストリームの容量確認
Lambda・SQS等のターゲットが1MBイベントを処理できるか検証してください。

任意

include_fieldsの活用
不要フィールドを除外してペイロードを1MB以内に収める設計も引き続き有効です。

Amazon EventBridge経由のWebhookペイロード上限が1MBに自動拡大されたことで、大型商品・注文データのインライン受信が可能になり、Admin APIへの二次取得コストとパイプラインの複雑さを削減できます。