---
title: "Get webhook by id"
method: GET
path: "/webhooks/{webhookId}"
tags: ["Webhooks V2"]
---

# Get webhook by id

`GET /webhooks/{webhookId}`

## Request

- Base URL: `https://api.fireblocks.io/v1`
- URL: `https://api.fireblocks.io/v1/webhooks/{webhookId}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/fireblocks/apis/fireblocks-api/docs/webhooks/:webhookId/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a webhook by its id

## Path parameters

- `webhookId` string, uuid, required

## Response `200`

A webhook object

- Webhook
  - `id` string, uuid, required: The id of the webhook
  - `url` string, required: The url of the webhook where notifications will be sent. Must be a valid URL and https.
  - `description` string: description of the webhook of what it is used for
  - `events` WebhookEvent[], required: The events that the webhook will be subscribed to
  - `status` 'DISABLED' | 'ENABLED' | 'SUSPENDED', required: The status of the webhook
  - `createdAt` integer, required: The date and time the webhook was created in milliseconds
  - `updatedAt` integer, required: The date and time the webhook was last updated in milliseconds
  - `webhookMtlsId` string, uuid: The id of the mTLS configuration this webhook presents when delivering, from `/v1/webhooks_settings/mtls`. Absent when the webhook does not use mTLS.
  - `webhookOauthId` string, uuid: The id of the OAuth credentials this webhook authenticates with. Absent when the webhook does not use OAuth. Read the credentials themselves from `/v1/webhooks_settings/oauth/{webhookOauthId}`.
  - `customHeaders` string[]: Names of the custom headers configured for this webhook. Header values are never returned.

## Other responses

- `default`: Error Response

---

[API](https://skmtc.dev/fireblocks/apis/fireblocks-api.md) - [All operations](https://skmtc.dev/fireblocks/apis/fireblocks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fireblocks/apis/fireblocks-api/revisions/4eba9965659a?raw)