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

# List all webhooks

`GET /webhooks`

Returns all defined webhooks for the requesting application.

This API only returns webhooks that are applied to files or folders that are
owned by the authenticated user. This means that an admin can not see webhooks
created by a service account unless the admin has access to those folders, and
vice versa.

## Query parameters

- `marker` string
- `limit` integer

## Response `200`

Returns a list of webhooks.

- Webhooks — The part of an API response that describes marker based pagination.
  - `limit` integer — The limit that was used for these entries. This will be the same as the `limit` query parameter unless that value exceeded the maximum value allowed. The maximum value varies by API.
  - `next_marker` string, nullable — The marker for the start of the next page of results.
  - `prev_marker` string, nullable — The marker for the start of the previous page of results.
  - `entries` WebhookMini[] — A list of webhooks.
    - `id` string — The unique identifier for this webhook.
    - `type` 'webhook' — The value will always be `webhook`.
    - `target` object — The item that will trigger the webhook.
      - `id` string — The ID of the item to trigger a webhook.
      - `type` 'file' | 'folder' — The type of item to trigger a webhook.

## Other responses

- `403` — Returns an error if the application does not have the permission to manage webhooks.
- `default` — An unexpected client error.

---

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