---
title: "List all webhook subscriptions"
method: GET
path: "/webhooks"
tags: ["Manage webhooks"]
---

# List all webhook subscriptions

`GET /webhooks`

List all webhook subscriptions

## Query parameters

- `after` string, nullable
- `before` string, nullable
- `limit` integer

## Response `200`

OK

- WebhookSubscriptionPagedDocsExample
  - `url` string
  - `results` WebhookSubscriptionDTO[]
    - `id` string — The unique identifier of the webhook subscription
    - `target_url` string — The HTTPS target URL that receives webhook deliveries
    - `secret` string, nullable — The secret used to sign webhook deliveries
    - `delivery` WebhookSubscriptionDeliveryDTO
      - `status` 'active' | 'inactive'
      - `reason` 'repeated_delivery_failure' | 'subscription_cancelled', nullable — The reason the webhook subscription became inactive, if any
    - `events` WebhookEventDTO[] — The webhook events configured for this subscription
      - `type` 'message_inbound' | 'message_outbound' | 'message_failed' | 'note_created' | 'contact_created' | 'contact_updated' | 'contact_deleted' | 'conversation_opened' | 'conversation_done' | 'conversation_snoozed' | 'conversation_deleted' | 'ai_call_completed'
      - `filters` union[] — The filters applied to this webhook event subscription
        - union
          - WEBHOOKEVENTFILTERINBOX
            - `ids` InboxPublicId[] — The inbox identifiers this webhook event is filtered by
              - …
            - `type` 'inbox'
          - WEBHOOKEVENTFILTERCHANNEL
            - `ids` MessageChannelConfigPublicId[] — The channel identifiers this webhook event is filtered by
              - …
            - `type` 'channel'
          - WEBHOOKEVENTFILTERCUSTOMATTRIBUTE
            - `ids` ContactAttributePublicId[] — The custom attribute identifiers this webhook event is filtered by
              - …
            - `type` 'custom_attribute'
          - WEBHOOKEVENTFILTERDEFAULTATTRIBUTE
            - `attributes` ContactWriteDefaultAttributeField[] — The built-in contact attributes this webhook event is filtered by
            - `type` 'default_attribute'
          - WEBHOOKEVENTFILTERHANDLE
            - `handle_types` ContactHandleType[] — The contact handle types this webhook event is filtered by
            - `type` 'handle'
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `url` string — The URL of the webhook subscription resource
  - `pagination` Pagination
    - `next_cursor` string, nullable
    - `previous_cursor` string, nullable
    - `next_url` string, nullable
    - `previous_url` string, nullable

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/superchat/apis/superchat-api.md) · [All operations](https://skmtc.dev/superchat/apis/superchat-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/superchat/superchat-api/revisions/3bc557a0072f/schema)