> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mangopay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# The Hook object

### Description

A webhook is a technical approach that allows Mangopay to submit a notification to other applications whenever a specific event occurs.

The Hook object allows you to receive notifications, to a URL you define, that are triggered by a specific event type. You can set up only one URL for each event type.

<Check>
  **Best practice – Idempotent hook processing**

  The retry feature (i.e., new notification if your app was unreachable) can set the hook to `INVALID`. We strongly recommend you make your event processing idempotent to avoid receiving duplicate notifications for the same events.
</Check>

### Attributes

<ParamField body="Url" type="string">
  Max. length: 255 characters

  The URL (http or https) to which the notification is sent.
</ParamField>

<ParamField body="Status" type="string">
  **Returned values:** `DISABLED`, `ENABLED`

  Whether the hook is enabled or not.
</ParamField>

<ParamField body="Validity" type="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.
</ParamField>

<ParamField body="EventType" type="string">
  **Returned values:** An `EventType` listed in the <a href="/webhooks/event-types">event types list</a>

  The type of the event.
</ParamField>

### Related resources

<Card title="Guide" href="/webhooks">Learn more about hook notifications</Card>