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

# Update a webhook

`PATCH /v2/webhooks/{webhookId}`

Updates the webhook. You may edit the name, url and the list of subscribed event types.

## Headers

- `idempotency-key` string

## Request body

- object
  - `name` string — A name that identifies the webhook.
  - `url` string — The URL Mollie will send the events to. This URL must be publicly accessible.
  - `eventTypes` union
    - WebhookEventTypes[] — The list of events to enable for this webhook. You may specify `'*'` to add all events, except those that require explicit selection.
    - 'payment.paid' | 'payment.authorized' | 'payment.failed' | 'payment.canceled' | 'payment.expired' | 'payment.pending' | 'refund.queued' | 'refund.pending' | 'refund.processing' | 'refund.refunded' | 'refund.failed' | 'refund.canceled' | 'chargeback.received' | 'chargeback.reversed' | 'capture.succeeded' | 'capture.failed' | 'payment-link.paid' | 'balance-transaction.created' | 'payout.initiated' | 'payout.processing-at-bank' | 'payout.completed' | 'payout.canceled' | 'payout.failed' | 'sales-invoice.created' | 'sales-invoice.issued' | 'sales-invoice.canceled' | 'sales-invoice.paid' | 'sales-invoice.e-invoice-failed' | 'sales-invoice.e-invoice-issued' | 'business-account-transfer.requested' | 'business-account-transfer.initiated' | 'business-account-transfer.pending-review' | 'business-account-transfer.processed' | 'business-account-transfer.failed' | 'business-account-transfer.blocked' | 'business-account-transfer.returned' | '*' — The list of events to enable for this webhook. You may specify `'*'` to add all events, except those that require explicit selection.
  - `testmode` boolean — Whether the entity was created in test mode or live mode. This field does not update the mode of the entity. Most API credentials are specifically created for either live mode or test mode, in which case this parameter must not be sent. For organization-level credentials such as OAuth access tokens, you can enable test mode by setting `testmode` to `true`.

## Response `200`

The webhook object.

## Other responses

- `404` — No entity with this ID exists.
- `422` — The request contains issues. For example, if the URL is invalid.
- `429` — Rate Limit has been reached.

---

[API](https://skmtc.net/mollie/apis/mollie-api.md) · [All operations](https://skmtc.net/mollie/apis/mollie-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mollie/mollie-api/versions/8b6839e22c14/schema)