> ## Documentation Index
> Fetch the complete documentation index at: https://docs.launchmystore.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List Webhook Subscriptions

> List your app's webhook subscriptions on the installed store

# List Webhook Subscriptions

Returns every webhook subscription your app has on the store the access
token belongs to — the ones created through
[`POST /api/v1/webhooks.json`](https://docs.launchmystore.io/api-reference/webhooks/create) and the ones
declared in your app manifest's `webhooks[]`. Only your own app's
subscriptions are ever returned.

Any valid access token for the installation may call this endpoint; no
scope is required.

## Request

```bash cURL theme={null}
curl "https://api.launchmystore.io/api/v1/webhooks.json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

```javascript Node.js theme={null}
const response = await fetch('https://api.launchmystore.io/api/v1/webhooks.json', {
  headers: { 'Authorization': `Bearer ${accessToken}` },
});
const { data } = await response.json();
```

## Response

**data.webhooks** `object[]`

Newest first.

**properties**

**id** `string`

Subscription id.

**topic** `string`

The subscribed topic.

**address** `string`

The callback URL (same as `callbackUrl`).

**source** `string`

`api` — created through the API, signed with its own secret;
`manifest` — declared in your app manifest, signed with your app's
client secret.

**isEnabled** `boolean`

Whether deliveries are sent.

**format** `string`

Always `json`.

The signing secret is never included — an API subscription's secret is
returned once, when it is created.

## Example Response

```json theme={null}
{
  "status": 200,
  "state": "success",
  "data": {
    "webhooks": [
      {
        "id": "125fc7e5-8600-4075-a962-368615e78a3b",
        "address": "https://your-app.com/webhooks/orders",
        "appWebhookId": "125fc7e5-8600-4075-a962-368615e78a3b",
        "appId": "3b0f5a2e-…",
        "storeId": "ef10744c-…",
        "topic": "orders/create",
        "callbackUrl": "https://your-app.com/webhooks/orders",
        "isEnabled": true,
        "format": "json",
        "source": "api",
        "createdAt": "2026-09-27T10:48:12.000Z",
        "updatedAt": "2026-09-27T10:48:12.000Z"
      },
      {
        "id": "8b1e2f3a-…",
        "address": "https://your-app.com/webhooks/uninstalled",
        "topic": "app/uninstalled",
        "callbackUrl": "https://your-app.com/webhooks/uninstalled",
        "isEnabled": true,
        "format": "json",
        "source": "manifest"
      }
    ]
  }
}
```

## Errors

| Status | When |
| - | - |
| `401` | Missing, invalid or expired access token. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.