---
title: "List webhook subscriptions"
method: GET
path: "/1.0/webhook_subscriptions"
tags: ["WebhookSubscriptions"]
---

# List webhook subscriptions

`GET /1.0/webhook_subscriptions`

## Request

- Base URL: `https://api.squarespace.com`
- URL: `https://api.squarespace.com/1.0/webhook_subscriptions`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/squarespace/apis/commerce-api/docs/1.0/webhook_subscriptions/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves information for all webhook subscriptions. The response contains up to 25 Webhook Subscriptions. Requires an OAuth access token; API keys are not supported.

## Headers

- `Authorization` string, required
- `User-Agent` string, required

## Response `200`

OK

- ExternalWebhookSubscriptionListResponse
  - `webhookSubscriptions` ExternalWebhookSubscriptionResponse[]: Array of Webhook Subscription resources. If the merchant site doesn't have any webhook subscriptions, this array is empty.
    - `clientId` string: Third-party client id.
    - `createdOn` string: ISO 8601 UTC date and time string; represents when the webhook subscription was created.
    - `endpointUrl` string: HTTPS URL that receives webhook notifications.
    - `id` string: Unique Webhook Subscription id.
    - `topics` string[]: List of event topics that trigger a webhook notification. Possible values include: extension.uninstall, order.create, order.update.
    - `updatedOn` string: ISO 8601 UTC date and time string; represents when the webhook subscription was last modified.
    - `websiteId` string: Unique website id.

## Other responses

- `404`: Not found. The API version is not supported.

---

[API](https://skmtc.dev/squarespace/apis/commerce-api.md) - [All operations](https://skmtc.dev/squarespace/apis/commerce-api/llms.txt) - [OpenAPI document](https://skmtc.dev/squarespace/apis/commerce-api/revisions/5dd4b1b7cd38?raw)