---
title: "Retrieve webhook"
method: GET
path: "/webhook/{webhook_uuid}"
tags: ["Org Level Webhooks"]
---

# Retrieve webhook

`GET /webhook/{webhook_uuid}`

## Request

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

This API retrieves a specific webhook using its universally unique identification code (UUID).

---
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).

## Path parameters

- `webhook_uuid` string, uuid, required

## Response `200`

OK

- InlineResponse2006
  - `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` 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.

## Other responses

- `400`: Webhook not found

---

[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)