---
title: "Get a webhook"
method: GET
path: "/v2/webhooks/{webhookId}"
tags: ["Webhooks API"]
---

# Get a webhook

`GET /v2/webhooks/{webhookId}`

## Request

- Base URL: `https://api.mollie.com`
- URL: `https://api.mollie.com/v2/webhooks/{webhookId}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://my.mollie.com/oauth2/authorize`
    - Token URL: `https://api.mollie.com/oauth2/tokens` scopes: `webhooks.read`

Retrieve a single webhook object by its ID.

> 🔑 Access with
>
> [Advanced access token with **webhooks.read**](/reference/authentication)
>
> [OAuth access with **webhooks.read**](/reference/authentication)

## Query parameters

- `testmode` boolean

## Response `200`

The webhook object.

- object
  - `resource` string, required: Indicates the response contains a webhook subscription object. Will always contain the string `webhook` for this endpoint.
  - `id` string, required: The identifier uniquely referring to this subscription.
  - `url` string, required: The subscription's events destination.
  - `profileId` string, nullable, required: The identifier uniquely referring to the profile that created the subscription.
  - `createdAt` string, required: The subscription's date time of creation.
  - `name` string, required: The subscription's name.
  - `eventTypes` string[], required: The events types that are subscribed.
  - `status` string, required: The subscription's current status. Possible values: `enabled` `blocked` `disabled` `deleted`
  - `mode` string, required: Whether this entity was created in live mode or in test mode. Possible values: `live` `test`
  - `_links` object, required: An object with several relevant URLs. Every URL object will contain an `href` and a `type` field.
    - `self` object, required: In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field.
      - `href` string, required: The actual URL string.
      - `type` string, required: The content type of the page or endpoint the URL points to.
    - `documentation` object, required: In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field.
      - `href` string, required: The actual URL string.
      - `type` string, required: The content type of the page or endpoint the URL points to.

## Other responses

- `404`: No entity with this ID exists.
- `422`: The request contains issues. For example, if the webhook has already been deleted.
- `429`: Rate Limit has been reached.

---

[API](https://skmtc.dev/mollie/apis/mollie-connect.md) - [All operations](https://skmtc.dev/mollie/apis/mollie-connect/llms.txt) - [OpenAPI document](https://skmtc.dev/mollie/apis/mollie-connect/revisions/65271e79a786?raw)