v55

latestOpenAPI 3.1.0CC-BY-NC-SA-4.0raw.githubusercontent.com2026-08-011243791.8 MB

Webhooks API

Create a webhook

A webhook must have a name, an url and a list of event types. You can also create webhooks in the webhooks settings section of the Dashboard.

post/v2/webhooks

idempotency-keystring

Example:123e4567-e89b-12d3-a456-426

A unique key to ensure idempotent requests. This key should be a UUID v4 string.

namestring required

A name that identifies the webhook.

urlstring required

The URL Mollie will send the events to. This URL must be publicly accessible.

testmodeboolean

Whether to create the entity in test mode or live mode.

You can enable test mode by setting testmode to true.

{
  "name": "Webhook #1",
  "url": "https://mollie.com/",
  "eventTypes": [
    "payment-link.paid"
  ]
}

The webhook object.