---
title: "List all Webhooks"
method: GET
path: "/network-services/v1/webhooks"
tags: ["Webhooks"]
---

# List all Webhooks

`GET /network-services/v1/webhooks`

This API endpoint retrieves a list of Webhooks and the details associated to the receiver such as the endpointURL and the authMechanism along with createdAt and updatedAt timestamps.

## Response `200`

Returns list of webhooks created by the customer.

- object
  - `items` object[], required — A list of webhooks created by the customer.
    - `id` string, uuid, required — The unique identifier of the webhook.
    - `type` string, required — The type of the resource.
    - `name` string — Name of the webhook. Must be unique per customer.
    - `endpoint` string — The URL to which the webhook payloads will be sent.
    - `authMechanism` 'API_KEY' | 'OIDC' — The authentication mechanism to be used for the webhook.
    - `generation` integer — Generation number of the webhook.
    - `createdAt` string, date-time — Provides the timestamp ISO 8601 format when the computed client location is persisted in database.
    - `updatedAt` string, date-time — Time when the resource was last updated.
  - `totalCount` integer — The total number of webhooks available.
  - `count` integer, required — The number of webhooks in the current response.

## Other responses

- `400` — Invalid input received.
- `401` — Unauthorized. Authentication credentials are required or invalid.
- `403` — Forbidden: Access is denied.
- `404` — Not Found error.
- `429` — Too Many Requests. The user has sent too many requests in a given amount of time.
- `500` — Internal Server Error. An unexpected error occurred on the server.

---

[API](https://skmtc.net/arubanetworks/apis/authorization.md) · [All operations](https://skmtc.net/arubanetworks/apis/authorization/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arubanetworks/authorization/revisions/74c95058b11f/schema)