Accounts API4

Balance Transfers API3

Balances API5

Capabilities API1

Captures API3

Chargebacks API3

Checkout Sessions API2

Client Links API1

Clients API2

Customers API7

Delayed Routing API3

Draft Transfers API4

Invoices API2

Mandates API4

Methods API7

OAuth API2

Onboarding API2

Organizations API3

Payment Links API6

Payments API6

Payouts API4

Permissions API2

Profiles API6

Refunds API5

Sales Invoices API5

Settlements API8

Subscriptions API7

Terminals API6

Transfers API2

Unmatched Credit Transfers API4

Verify Payee API1

Wallets API1

Webhook Events API1

Webhooks API6

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

Headers

idempotency-keystring

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

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

Request body

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.

Example request

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

Response

The webhook object.

Changes

Changed in 6 of the 78 revisions of this API.1839

Jul 2, 2026e8c8cac7138048See the full diff
- ●
  added the new capture.failed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new capture.succeeded enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new chargeback.received enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new chargeback.reversed enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  added the new capture.failed enum value to the request property ////
  request-property-enum-value-added
- ○
  added the new capture.failed enum value to the request property //
  request-property-enum-value-added
- ○
  added the new capture.succeeded enum value to the request property ////
  request-property-enum-value-added
- ○
  added the new capture.succeeded enum value to the request property //
  request-property-enum-value-added
- ○
  added the new chargeback.received enum value to the request property ////
  request-property-enum-value-added
- ○
  added the new chargeback.received enum value to the request property //
  request-property-enum-value-added
- ○
  added the new chargeback.reversed enum value to the request property ////
  request-property-enum-value-added
- ○
  added the new chargeback.reversed enum value to the request property //
  request-property-enum-value-added
Jun 22, 202619c365c4aee424See the full diff
- ●
  added the new sales-invoice.e-invoice-failed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new sales-invoice.e-invoice-issued enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  added the new sales-invoice.e-invoice-failed enum value to the request property ////
  request-property-enum-value-added
- ○
  added the new sales-invoice.e-invoice-failed enum value to the request property //
  request-property-enum-value-added
- ○
  added the new sales-invoice.e-invoice-issued enum value to the request property ////
  request-property-enum-value-added
- ○
  added the new sales-invoice.e-invoice-issued enum value to the request property //
  request-property-enum-value-added
May 19, 20267cab62b218301See the full diff
- ○
  added the non-success response with the status
  response-non-success-status-added
May 12, 2026f5e0eb3b7313510See the full diff
- ●
  added the new payout.canceled enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new payout.completed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new payout.failed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new payout.initiated enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new payout.processing-at-bank enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  added the new payout.canceled enum value to the request property ////
  request-property-enum-value-added
- ○
  added the new payout.canceled enum value to the request property //
  request-property-enum-value-added
- ○
  added the new payout.completed enum value to the request property ////
  request-property-enum-value-added
- ○
  added the new payout.completed enum value to the request property //
  request-property-enum-value-added
- ○
  added the new payout.failed enum value to the request property ////
  request-property-enum-value-added
- ○
  added the new payout.failed enum value to the request property //
  request-property-enum-value-added
- ○
  added the new payout.initiated enum value to the request property ////
  request-property-enum-value-added
- ○
  added the new payout.initiated enum value to the request property //
  request-property-enum-value-added
- ○
  added the new payout.processing-at-bank enum value to the request property ////
  request-property-enum-value-added
- ○
  added the new payout.processing-at-bank enum value to the request property //
  request-property-enum-value-added
May 12, 2026ef4b5a97b56a2See the full diff
- ○
  the endpoint scheme security advancedAccessToken was added to the API
  api-security-added
- ○
  the endpoint scheme security organizationAccessToken was removed from the API
  api-security-removed
This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Apr 28, 2026e5af12275c86714See the full diff
- ●
  added the new business-account-transfer.blocked enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new business-account-transfer.failed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new business-account-transfer.initiated enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new business-account-transfer.pending-review enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new business-account-transfer.processed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new business-account-transfer.requested enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new business-account-transfer.returned enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  added the new business-account-transfer.blocked enum value to the request property ////
  request-property-enum-value-added
- ○
  added the new business-account-transfer.blocked enum value to the request property //
  request-property-enum-value-added
- ○
  added the new business-account-transfer.failed enum value to the request property ////
  request-property-enum-value-added
- ○
  added the new business-account-transfer.failed enum value to the request property //
  request-property-enum-value-added
- ○
  added the new business-account-transfer.initiated enum value to the request property ////
  request-property-enum-value-added
- ○
  added the new business-account-transfer.initiated enum value to the request property //
  request-property-enum-value-added
- ○
  added the new business-account-transfer.pending-review enum value to the request property ////
  request-property-enum-value-added
- ○
  added the new business-account-transfer.pending-review enum value to the request property //
  request-property-enum-value-added
- ○
  added the new business-account-transfer.processed enum value to the request property ////
  request-property-enum-value-added
- ○
  added the new business-account-transfer.processed enum value to the request property //
  request-property-enum-value-added
- ○
  added the new business-account-transfer.requested enum value to the request property ////
  request-property-enum-value-added
- ○
  added the new business-account-transfer.requested enum value to the request property //
  request-property-enum-value-added
- ○
  added the new business-account-transfer.returned enum value to the request property ////
  request-property-enum-value-added
- ○
  added the new business-account-transfer.returned enum value to the request property //
  request-property-enum-value-added

Of the 78 revisions, 9 have no diff computed.

Full history