---
title: "List all the the webhook and their subscriptions"
method: GET
path: "/v1/webhooks"
tags: ["Webhooks"]
---

# List all the the webhook and their subscriptions

`GET /v1/webhooks`

Lists all the webhook and their subscriptions

## Query parameters

- `cursor` integer
- `limit` integer

## Response `200`

Successful Response

- ExternalApiListResponseExternalWebhookResponseSchema
  - `data` ExternalWebhookResponseSchema[], required
    - `webhook` ReadWebhookSchema, required
      - `event` 'account.created' | 'account.updated' | 'conversation.created' | 'conversation.agent' | 'conversation.tags' | 'conversation.custom_fields' | 'conversation.status' | 'conversation.priority' | 'conversation.message' | 'conversation.message.delivery_status' | 'conversation.message.deprecated' | 'customer.identify' | 'customer.created' | 'customer.updated' | 'customer.custom_fields' | 'customer.notes' | 'customer.notes.deleted' | 'session.finished' | 'sidebar.sent' | 'sidebar.received', required
      - `category` 'CONVERSATION' | 'ACCOUNT' | 'CUSTOMER' | 'NOTES' | 'SESSION', required
      - `displayName` string, required
      - `description` string
    - `subscriptions` ExternalReadWebhookSubscriptionSchema[]
      - `id` string, uuid, required
      - `companyId` string, uuid, required
      - `event` 'account.created' | 'account.updated' | 'conversation.created' | 'conversation.agent' | 'conversation.tags' | 'conversation.custom_fields' | 'conversation.status' | 'conversation.priority' | 'conversation.message' | 'conversation.message.delivery_status' | 'conversation.message.deprecated' | 'customer.identify' | 'customer.created' | 'customer.updated' | 'customer.custom_fields' | 'customer.notes' | 'customer.notes.deleted' | 'session.finished' | 'sidebar.sent' | 'sidebar.received', required
      - `endpoint` string, uri, required
      - `endpointKey` string, required
      - `status` 'ACTIVE' | 'INACTIVE', required
      - `signingSecret` string, required
  - `total` integer, nullable
  - `cursor` integer, nullable
  - `limit` integer, nullable

## Other responses

- `422` — Validation Error

---

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