---
title: "Update a webhook subscription"
method: POST
path: "/webhook-subscriptions/{id}"
tags: ["webhook subscriptions"]
---

# Update a webhook subscription

`POST /webhook-subscriptions/{id}`

Update a webhook subscription to pause or resume webhook delivery notifications. Allows toggling the paused status to temporarily stop webhook notifications without deleting the subscription. Returns the updated subscription resource with the new paused status. Use this endpoint to manage webhook delivery during maintenance or troubleshooting periods.

## Path parameters

- `id` string, required

## Headers

- `Accept` 'application/vnd.dwolla.v1.hal+json', required

## Request body

- object
  - `paused` boolean, required

## Response `200`

successful operation

## Other responses

- `400` — Bad Request
- `404` — Not Found

## Changes

- **2025-07-01** `633b30cf427d` — 1 breaking
  - added the new required `header` request parameter `Accept`
- **2025-06-06** `231d0268586b` — 1 breaking, 4 info
  - request body became required
  - the response property `code` became required for the status `400`
  - the response property `code` became required for the status `404`
  - the response property `message` became required for the status `400`
  - …1 more

[Change history](https://skmtc.dev/dwolla/apis/dwolla-api/changes/webhook-subscriptions/:id/post.md)

---

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