Shopify app webhook events

Shopify sends 5 app events, including app/uninstalled, app_purchases_one_time/update and app/scopes_update.

Every event here can also reach agents as an MCP event through Hookdeck: MCP events →

app/uninstalled

verified from a captured delivery

Shop uninstalls your app

Identified by x-shopify-topic header Resource app

shopify-app-uninstalled.json
{
  "id": 548380009,
  "name": "Super Toys",
  "email": "super@supertoys.com",
  "domain": null,
  "province": "Tennessee",
  "country": "US",
  "address1": "190 MacLaren Street",
  "zip": "37178",
  "city": "Houston"
}

Key fields

Field Type Example
id integer 548380009

Full schema: 55 fields.

Seen in a captured delivery

  • Content type application/json
  • API version 2026-07
  • Headers user-agent , content-type , x-shopify-api-version , x-shopify-hmac-sha256 , x-shopify-shop-domain , x-shopify-test , x-shopify-topic , x-shopify-triggered-at , x-shopify-webhook-id

Send example to Inspect → View as JSON

app_purchases_one_time/update

verified from a captured delivery

One-time app charge changes

Identified by x-shopify-topic header Resource app

shopify-app-purchases-one-time-update.json
{
  "app_purchase_one_time": {
    "admin_graphql_api_id": "gid://shopify/AppPurchaseOneTime/1017262349",
    "name": "Webhook Test",
    "status": "PENDING",
    "admin_graphql_api_shop_id": "gid://shopify/Shop/548380009",
    "created_at": "2021-12-31T19:00:00-05:00",
    "updated_at": "2021-12-31T19:00:00-05:00"
  }
}

Key fields

Field Type Example
app_purchase_one_time.status string PENDING
app_purchase_one_time.created_at string 2021-12-31T19:00:00-05:00

Full schema: 7 fields.

Seen in a captured delivery

  • Content type application/json
  • API version 2026-07
  • Headers user-agent , content-type , x-shopify-api-version , x-shopify-hmac-sha256 , x-shopify-shop-domain , x-shopify-test , x-shopify-topic , x-shopify-triggered-at , x-shopify-webhook-id

Send example to Inspect → View as JSON

app/scopes_update

verified from a captured delivery

Access scopes change on an app installation

Identified by x-shopify-topic header Resource app

shopify-app-scopes-update.json
{
  "id": 1,
  "shop_id": "gid://shopify/Shop/548380009",
  "previous": [ … ],
  "current": [ … ],
  "updated_at": "2024-06-25T00:00:00.000Z"
}

Key fields

Field Type Example
id integer 1
updated_at string 2024-06-25T00:00:00.000Z

Full schema: 7 fields.

Seen in a captured delivery

  • Content type application/json
  • API version 2026-07
  • Headers user-agent , content-type , x-shopify-api-version , x-shopify-event-id , x-shopify-hmac-sha256 , x-shopify-shop-domain , x-shopify-test , x-shopify-topic , x-shopify-triggered-at , x-shopify-webhook-id

Send example to Inspect → View as JSON

app_subscriptions/approaching_capped_amount

verified from a captured delivery

Usage balance passes 90% of an app subscription's cap

Identified by x-shopify-topic header Resource app

shopify-app-subscriptions-approaching-capped-amount.json
{
  "app_subscription": {
    "admin_graphql_api_id": "gid://shopify/AppSubscription/1029266948",
    "name": "Webhook Test",
    "balance_used": 0,
    "capped_amount": "20.0",
    "currency_code": "USD",
    "admin_graphql_api_shop_id": "gid://shopify/Shop/548380009",
    "created_at": "2021-12-31T19:00:00-05:00",
    "updated_at": "2021-12-31T19:00:00-05:00"
  }
}

Key fields

Field Type Example
app_subscription.capped_amount string 20.0 Watch out Numeric string.
app_subscription.created_at string 2021-12-31T19:00:00-05:00

Full schema: 9 fields.

Seen in a captured delivery

  • Content type application/json
  • API version 2026-07
  • Headers user-agent , content-type , x-shopify-api-version , x-shopify-hmac-sha256 , x-shopify-shop-domain , x-shopify-test , x-shopify-topic , x-shopify-triggered-at , x-shopify-webhook-id

Send example to Inspect → View as JSON

app_subscriptions/update

verified from a captured delivery

App subscription changes

Identified by x-shopify-topic header Resource app

shopify-app-subscriptions-update.json
{
  "app_subscription": {
    "admin_graphql_api_id": "gid://shopify/AppSubscription/1029266947",
    "name": "Webhook Test",
    "status": "PENDING",
    "admin_graphql_api_shop_id": "gid://shopify/Shop/548380009",
    "created_at": "2021-12-31T19:00:00-05:00",
    "updated_at": "2021-12-31T19:00:00-05:00",
    "currency": "USD",
    "capped_amount": null
  }
}

Key fields

Field Type Example
app_subscription.status string PENDING
app_subscription.created_at string 2021-12-31T19:00:00-05:00

Full schema: 12 fields.

Seen in a captured delivery

  • Content type application/json
  • API version 2026-07
  • Headers content-type , user-agent , x-shopify-api-version , x-shopify-hmac-sha256 , x-shopify-shop-domain , x-shopify-test , x-shopify-topic , x-shopify-webhook-id

Send example to Inspect → View as JSON

Route Shopify events by type.

Event Gateway receives every Shopify delivery and filters and routes it by event type, so each service gets only the events it handles.

Not affiliated with Shopify. Facts are compiled from public sources and linked inline.