---
title: "Get Hook"
method: GET
path: "/hooks/{hookId}"
tags: ["hooks"]
---

# Get Hook

`GET /hooks/{hookId}`

Retrieves the details of a specific webhook using its ID.

## Path parameters

- `hookId` string, required

## Response `200`

Success

- HookDetail — Full configuration details for a webhook, including its scope and subscription.
  - `id` string, required — A unique identifier for the webhook.
  - `object` 'hook', required — Fixed value identifying this object as a webhook.
  - `name` string, required — A user-defined name to label the webhook.
  - `events` string[], required — List of event types this webhook is subscribed to.
  - `chatId` string — Optional ID of the chat that this webhook is scoped to.
  - `url` string, required — Target URL that receives event payloads for this webhook.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `413` — Payload Too Large
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `500` — Internal Server Error

## Changes

- **2025-09-08** `9924b1bf0d99` — 1 warning
  - added the new `message.finished` enum value to the `events/items/` response property for the response status `200`
- **2025-08-24** `3521652a43a7` — 1 info
  - removed the `message.finished` enum value from the `events/items/` response property for the response status `200`

[Change history](https://skmtc.dev/vercel/apis/v0-platform-api-beta/changes/hooks/:hookId/get.md)

---

[API](https://skmtc.dev/vercel/apis/v0-platform-api-beta.md) · [All operations](https://skmtc.dev/vercel/apis/v0-platform-api-beta/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vercel/v0-platform-api-beta/revisions/79811cd54faa/schema)