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

# List webhook subscriptions

`GET /webhook_subscriptions`

List existing webhook subscriptions.

The `filter_type` and `filter_id` query parameters may be used to only show subscriptions
for a particular _service_ or _team_.

For more information on webhook subscriptions and how they are used to configure v3 webhooks
see the [Webhooks v3 Developer Documentation](https://developer.pagerduty.com/docs/webhooks/v3-overview/).

Scoped OAuth requires: `webhook_subscriptions.read`

## Query parameters

- `limit` integer
- `offset` integer
- `total` boolean
- `filter_type` 'account' | 'service' | 'team'
- `filter_id` string

## Headers

- `Accept` string, required

## Response `200`

A set of webhook subscriptions matching the request.

- object
  - `webhook_subscriptions` WebhookSubscription[], required
    - `id` string
    - `type` 'webhook_subscription', required — The type indicating the schema of the object.
    - `active` boolean — Determines whether this subscription will produce webhook events.
    - `delivery_method` object, required
      - `id` string
      - `secret` string, nullable — The secret used to sign webhook payloads. Only provided on the initial create response.
      - `temporarily_disabled` boolean — Whether or not this webhook subscription is temporarily disabled. Becomes `true` if the delivery method URL is repeatedly rejected by the server.
      - `type` 'http_delivery_method', required — Indicates the type of the delivery method.
      - `url` string, url, required — The destination URL for webhook delivery.
      - `custom_headers` object[] — Optional headers to be set on this webhook subscription when sent. The header values are redacted in GET requests, but are not redacted on the webhook when delivered to the webhook's endpoint.
        - `name` string — The header name
        - `value` string — The header value
    - `description` string — A short description of the webhook subscription.
    - `events` string[], required — The set of outbound event types the webhook will receive.
    - `filter` object, required
      - `id` string — The id of the object being used as the filter. This field is required for all filter types except account_reference.
      - `type` 'account_reference' | 'service_reference' | 'team_reference', required — The type of object being used as the filter.
    - `oauth_client` object — OAuth client details. This field is populated in responses when oauth_client_id is set.
      - `id` string, required — The ID of the OAuth client
      - `type` 'oauth_client_reference', required — The type of object being referenced
      - `summary` string — A short-form, server-generated string that provides succinct, important information about an object suitable for primary labeling of an entity in a client
  - `offset` integer — Echoes offset pagination property.
  - `limit` integer — Echoes limit pagination property.
  - `more` boolean — Indicates if there are additional records to return
  - `total` integer, nullable — The total number of records matching the given query.

## Other responses

- `400` — Caller provided invalid arguments. Please review the response for error details. Retrying with the same arguments will *not* work.
- `401` — Caller did not supply credentials or did not provide the correct credentials. If you are using an API key, it may be invalid or your Authorization header may be malformed.
- `403` — Caller is not authorized to view the requested resource. While your authentication is valid, the authenticated user or token does not have permission to perform this action.

---

[API](https://skmtc.net/pagerduty/apis/rest-api.md) · [All operations](https://skmtc.net/pagerduty/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pagerduty/rest-api/versions/b679a8f3f02c/schema)