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

# List webhooks

`GET /webhooks`

## Request

- Base URL: `https://api.ocrolus.com/v1/account/settings`
- URL: `https://api.ocrolus.com/v1/account/settings/webhooks`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://auth.ocrolus.com/oauth/token`

This API retrieves a list of all the webhooks configured for your organization.

---
You can find a list of supported org-level event types and their sample notifications in the [Org-level webhook guide](doc:organization-level-webhook#available-events).

## Response `200`

OK

- InlineResponse2005
  - `status` string: The success response status received from the server.
  - `message` string: The success message received from the server corresponding to the response status.
  - `response` InlineResponse2005Response
    - `webhooks` Webhook[]
      - `description` string: A brief description of the webhook. A description is not required but if provided, a minimum of 3 characters is required with a maximum length of 255.
      - `url` string: A unique resource locator (URL) of the webhook. Ocrolus will attempt to send a notification to this URL to notify about any configured events.
      - `uuid` string, uuid: The universally unique identification code (UUID) of the webhook.
      - `is_active` boolean: Determines if notificiations will be sent to the provided webhook.
      - `created_on` string: The timestamp at which the webhook is created.
      - `last_modified_date` string: The timestamp at which the webhook was last modified.

---

[API](https://skmtc.dev/ocrolus/apis/org-level-webhooks.md) - [All operations](https://skmtc.dev/ocrolus/apis/org-level-webhooks/llms.txt) - [OpenAPI document](https://skmtc.dev/ocrolus/apis/org-level-webhooks/revisions/ef603756da38?raw)