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
app/uninstalled Shop uninstalls your app
Identified by x-shopify-topic header
Resource app
{
"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
app_purchases_one_time/update
verified from a captured delivery
app_purchases_one_time/update One-time app charge changes
Identified by x-shopify-topic header
Resource app
{
"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
app/scopes_update
verified from a captured delivery
app/scopes_update Access scopes change on an app installation
Identified by x-shopify-topic header
Resource app
{
"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
app_subscriptions/approaching_capped_amount
verified from a captured delivery
app_subscriptions/approaching_capped_amount Usage balance passes 90% of an app subscription's cap
Identified by x-shopify-topic header
Resource app
{
"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
app_subscriptions/update
verified from a captured delivery
app_subscriptions/update App subscription changes
Identified by x-shopify-topic header
Resource app
{
"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
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.