---
title: "List webhooks"
method: GET
path: "/webhooks"
tags: ["webhooks"]
---

# List webhooks

`GET /webhooks`

## Request

- Base URL: `https://cyber-risk.upguard.com/api/public`
- URL: `https://cyber-risk.upguard.com/api/public/webhooks`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/upguard/apis/upguard-cyberrisk-api/docs/webhooks/get.ts> (a function with typed inputs; its response is checked against the schema)

List all registered webhooks.

Required API key permissions: `Admin` (select when creating API key in Account Settings)

## Response `200`

List of registered webhooks

- ListWebhookResponsePayload
  - `webhooks` Webhook[]: The list of registered webhooks
    - `enabled` boolean: Flag indicating whether the webhook is enabled or disabled
    - `id` string: The ID of the webhook
    - `name` string: The name of the webhook
    - `notification_type_ids` string[]: The list of notifications IDs registered for this webhook
    - `url` string: The URL used by the webhook to send notifications to
    - `webhook_type` 'zapier' | 'webhook' | 'workflow_webhook': The type of webhook

## Other responses

- `403`: Your API key does not have permission to perform this action.
- `429`: Too many requests have been made to this endpoint.
- `500`: An internal system error occurred

---

[API](https://skmtc.dev/upguard/apis/upguard-cyberrisk-api.md) - [All operations](https://skmtc.dev/upguard/apis/upguard-cyberrisk-api/llms.txt) - [OpenAPI document](https://skmtc.dev/upguard/apis/upguard-cyberrisk-api/revisions/d044bf6dc61e?raw)