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

# List Webhooks

`GET /api/v2/webhooks`

Retrieves a list of all webhooks for the authenticated team

## Response `200`

Successfully retrieved webhooks

- WebhooksListResponse
  - `data` Webhook[], required — List of webhook objects.
    - union
      - SlackWebhook
        - `id` string, required — Webhook ID
        - `name` string, required — Webhook name
        - `service` 'slack', required — Webhook service type
        - `url` string — Slack incoming webhook URL
        - `description` string — Webhook description, shown in the UI
        - `updatedAt` string, date-time, required — Last update timestamp
        - `createdAt` string, date-time, required — Creation timestamp
      - IncidentIOWebhook
        - `id` string, required — Webhook ID
        - `name` string, required — Webhook name
        - `service` 'incidentio', required — Webhook service type
        - `url` string — incident.io alert event HTTP source URL
        - `description` string — Webhook description, shown in the UI
        - `updatedAt` string, date-time, required — Last update timestamp
        - `createdAt` string, date-time, required — Creation timestamp
      - GenericWebhook
        - `id` string, required — Webhook ID
        - `name` string, required — Webhook name
        - `service` 'generic', required — Webhook service type
        - `url` string — Webhook destination URL
        - `description` string — Webhook description, shown in the UI
        - `body` string — Optional request body template
        - `updatedAt` string, date-time, required — Last update timestamp
        - `createdAt` string, date-time, required — Creation timestamp

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

## Changes

- **2026-02-27** `35626843b5a7` — 1 warning
  - removed the optional property `data/items/oneOf[#/components/schemas/GenericWebhook]/headers` from the response with the `200` status
- **2026-02-26** `05a896225fde` — 1 info
  - endpoint added
- **2026-01-30** `ed852374c451` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/hyperdxio/apis/hyperdx-external-api/changes/api/v2/webhooks/get.md)

---

[API](https://skmtc.dev/hyperdxio/apis/hyperdx-external-api.md) · [All operations](https://skmtc.dev/hyperdxio/apis/hyperdx-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hyperdxio/hyperdx-external-api/revisions/265bce0e134b/schema)