# 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](https://hookdeck.com/webhooks/shopify/mcp-events).

Agent skill: `npx skills add hookdeck/webhook-skills --skill shopify-webhooks` ([details](https://hookdeck.com/webhooks/shopify/skill))

> Independent reference generated from hookdeck/webhook-registry (commit a24c8d9, 19 Nov 2026). [Shopify's official docs](https://shopify.dev/docs/apps/build/webhooks/delivery-structure).

[Overview](https://hookdeck.com/webhooks/shopify) · [Webhook events (230)](https://hookdeck.com/webhooks/shopify/events) · [MCP events](https://hookdeck.com/webhooks/shopify/mcp-events) · [Verify signatures](https://hookdeck.com/webhooks/shopify/verify) · [Production guide](https://hookdeck.com/webhooks/shopify/guide-duplicates-ordering-retries-timeouts) · [Agent skill](https://hookdeck.com/webhooks/shopify/skill)

## app/uninstalled

Confidence: verified · Schema: from a captured delivery

Shop uninstalls your app

Identified by: x-shopify-topic header · Object: `app`

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

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/app-uninstalled.json)

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `548380009` |

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`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/app-uninstalled.json)

## app_purchases_one_time/update

Confidence: verified · Schema: from a captured delivery

One-time app charge changes

Identified by: x-shopify-topic header · Object: `app`

```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 field | Type | Example |
|---|---|---|
| `app_purchase_one_time.status` | string | `PENDING` |
| `app_purchase_one_time.created_at` | string | `2021-12-31T19:00:00-05:00` |

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`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/app-purchases-one-time-update.json)

## app/scopes_update

Confidence: verified · Schema: from a captured delivery

Access scopes change on an app installation

Identified by: x-shopify-topic header · Object: `app`

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

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/app-scopes-update.json)

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `1` |
| `updated_at` | string | `2024-06-25T00:00:00.000Z` |

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`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/app-scopes-update.json)

## app_subscriptions/approaching_capped_amount

Confidence: verified · Schema: from a captured delivery

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

Identified by: x-shopify-topic header · Object: `app`

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

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`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/app-subscriptions-approaching-capped-amount.json)

## app_subscriptions/update

Confidence: verified · Schema: from a captured delivery

App subscription changes

Identified by: x-shopify-topic header · Object: `app`

```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 field | Type | Example |
|---|---|---|
| `app_subscription.status` | string | `PENDING` |
| `app_subscription.created_at` | string | `2021-12-31T19:00:00-05:00` |

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`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/app-subscriptions-update.json)

---

Not affiliated with Shopify. Facts are compiled from public sources and linked inline. [View as JSON](https://hookdeck.com/webhooks/shopify.json) · [Report a correction](https://hookdeck.com/contact)
