---
title: "View a Hook"
method: GET
path: "/v2.01/{ClientId}/hooks/{HookId}"
tags: ["Webhooks"]
---

# View a Hook

`GET /v2.01/{ClientId}/hooks/{HookId}`

View a Hook

## Path parameters

- `ClientId` string, required
- `HookId` string, required

## Headers

- `Authorization` string, required

## Response `200`

Success

- HookResponse
  - `Url` string — Max. length: 255 characters The URL to which the notification is sent.
  - `Status` string — **Returned values:** `DISABLED`, `ENABLED` Whether the hook is enabled or not.
  - `Validity` string — **Returned values:** `VALID`, `INVALID` Whether the hook is valid or not. Once `INVALID` (following unsuccessful retries) the hook must be disabled and re-enabled.
  - `EventType` string — **Returned values:** An `EventType` listed in the <a href="/webhooks/event-types">event types list</a> The type of the event.
  - `Id` string — Max length: 128 characters (see [data formats](/api-reference/overview/data-formats) for details) The unique identifier of the object.
  - `Tag` string — Max. length: 255 characters Custom data that you can add to this object.
  - `CreationDate` integer — Unix timestamp (UTC) of the date and time the object was created.
  - `Email` string — Format: A valid email address The `Email` address to which alerts are sent in case of [consecutive failed notification attempts](/webhooks#notification-retries-and-failure). **Caution:** Mangopay may populate this property automatically if your platform had webhooks integrated in Production before April 2, 2026. If so, setting the `Email` on a single Hook stops this automatic population for any new Hooks you create - [read more](/webhooks#transition-from-default-email-april-2026). For all platforms, if this property is returned `null` then no alerts are sent but the Hook still becomes `INVALID` after 100 consecutive failed notifications.

---

[API](https://skmtc.dev/mangopay/apis/api-reference.md) · [All operations](https://skmtc.dev/mangopay/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mangopay/api-reference/revisions/fafbd0c69654/schema)