---
title: "List webhooks"
method: GET
path: "/webhooks"
---

# List webhooks

`GET /webhooks`

## Request

- Base URL: `https://osis.co/api/v1/comms`
- URL: `https://osis.co/api/v1/comms/webhooks`
- Auth: HTTP bearer

List your webhooks. Scope: `comms_webhooks`.

## Response `200`

Webhook list

- object
  - `webhooks` Webhook[]
    - `id` string
    - `url` string, uri
    - `events` string[]
    - `active` boolean
    - `secret` string
    - `createdAt` string, date-time

## Other responses

- `401`: API key is missing or wrong
- `403`: Your key doesn't have the scope this needs

---

[API](https://skmtc.dev/osis/apis/comms-api.md) · [All operations](https://skmtc.dev/osis/apis/comms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/osis/apis/comms-api/revisions/59a4c0ba8936?raw)