---
title: "Update Webhook Subscription"
method: POST
path: "/webhooks/update"
tags: ["Document AI — Webhooks"]
---

# Update Webhook Subscription

`POST /webhooks/update`

## Request

- Base URL: `https://api.paperoffice.ai/latest`
- URL: `https://api.paperoffice.ai/latest/webhooks/update`
- Auth: HTTP bearer

po_webhooks_update: Update an existing webhook subscription. Can change name, URL, events, secret, filters, headers, retry policy, active status, and timeouts. Keywords: update webhook, modify subscription, change webhook. Accepts...

## Request body

- object
  - `subscription_id` integer, required: ID of the Subscription (Required)
  - `name` string: New subscription name.
  - `url` string: New webhook URL.
  - `events` string[]: New event list.
  - `secret` string: New signing secret.
  - `filters` object: new Filter
  - `headers` object: New custom headers.
  - `is_active` boolean: Set subscription active (true) or inactive (false). Reactivation resets the auto-disable failure counter. Accepts true/false, 1/0, yes/no, on/off (JSON boolean or form string); other values return 400 INVALID_BOOLEAN.
  - `retry_policy` 'none' | 'linear' | 'exponential': Retry policy: none, linear, or exponential (default: exponential).
  - `max_retries` integer: New maximum retry count.
  - `timeout_ms` integer: New timeout in milliseconds.

## Response `200`

Success

- SuccessEnvelope: Success envelope. Payload fields are endpoint-specific (top-level fields, `result`/`job_result` for jobs, `data` on some account endpoints).
  - `status` 'success', required
  - `processing_time` union
    - string
    - number
  - `_billing` object

## Other responses

- `4XX`: Error
- `5XX`: Error

---

[API](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api.md) · [All operations](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api/revisions/c6a6228a4509?raw)