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

# Test a webhook

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

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

## Headers

- `idempotency-key` string

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

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

## Changes

> 78 revisions in range; 9 not diffed.

- **2026-05-19** `7cab62b21830` — 1 info
  - added the non-success response with the status `429`
- **2026-05-12** `ef4b5a97b56a` — 2 info
  - the endpoint scheme security `advancedAccessToken` was added to the API
  - the endpoint scheme security `organizationAccessToken` was removed from the API

[Change history](https://skmtc.dev/mollie/apis/mollie-api/changes/v2/webhooks/:webhookId/ping/post.md)

---

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