---
title: "Test a webhook"
method: POST
path: "/v2/webhooks/{webhookId}/ping"
tags: ["Webhooks API"]
---

# Test a webhook

`POST /v2/webhooks/{webhookId}/ping`

## Request

- Base URL: `https://api.mollie.com`
- URL: `https://api.mollie.com/v2/webhooks/{webhookId}/ping`
- 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.write`

Sends a test event to the webhook to verify the endpoint is working as expected.

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

## Request body

- object
  - `testmode` boolean: You can enable test mode by setting `testmode` to `true`. Test entities cannot be retrieved when the endpoint is set to live mode, and vice versa.

## Response `202`

Accepted.

- unknown

## 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)