---
title: >-
  Amazon EventBridge webhook payload size limit increased to 1 MB - Shopify
  developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/posts/amazon-eventbridge-webhook-payload-size-limit-increased-to-1-mb
  md: >-
    https://shopify.dev/changelog/posts/amazon-eventbridge-webhook-payload-size-limit-increased-to-1-mb.md
metadata:
  effectiveApiVersion: ''
  affectedApi:
    - displayName: Events & webhooks
      handle: webhook
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: false
  createdAt: '2026-11-16T17:18:15-05:00'
  postedAt: '2026-11-17T12:00:00-05:00'
  updatedAt: '2026-11-17T15:36:47-05:00'
  effectiveAt: '2026-11-17T12:00:00-05:00'
---

November 17, 2026

# Amazon EventBridge webhook payload size limit increased to 1 MB

DateNovember 17, 2026

FlagsUpdate

Tags[Events & webhooks](https://shopify.dev/changelog?api_type=webhook)

You can now receive [webhook](https://shopify.dev/docs/apps/build/webhooks) and [Events](https://shopify.dev/docs/apps/build/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.

## What changed

Previously, Amazon EventBridge deliveries capped payloads at 256 KB:

* 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](https://shopify.dev/docs/apps/build/events/delivery-structure#large-payloads) and delivered a temporary `payload_url` download link instead of the inline payload.

Shopify now sends raw UTF-8 payloads up to 1,000,000 bytes directly to your [Amazon EventBridge partner event source](https://shopify.dev/docs/apps/build/webhooks/get-started?deliveryMethod=eventBridge), leaving headroom under EventBridge's 1 MiB entry cap for the `source`, `detail-type`, and `detail` envelope. 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.

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`.

## What to do

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.

To review how your app handles large deliveries:

* 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`](https://shopify.dev/docs/apps/build/webhooks/delivery-structure#include_fields) and targeted Events `[events.subscription]` [`query`](https://shopify.dev/docs/apps/build/events/delivery-structure#custom-queries) 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.
