---
title: "List all Hooks"
method: GET
path: "/v2.01/{ClientId}/hooks"
tags: ["Webhooks"]
---

# List all Hooks

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

List all Hooks

This call returns all the Hooks that have been created for the platform. It includes both enabled and disabled hooks.

## Path parameters

- `ClientId` string, required

## Headers

- `Authorization` string, required

## Response `200`

Success

- ListAllHooksResponse
  - `Array (Hooks)` ListAllHooksResponseArrayHooksItems[] — The list of hooks created by the platform.
    - `Hook` ListAllHooksResponseArrayHooksItemsHook — The hook object created by the platform.
      - `Url` string — 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 — 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)