---
title: "Update Webhook (v1/v2 cannot be changed; register a new endpoint to switch version)"
method: PUT
path: "/v2/webhooks/{webhook_nanoid}"
tags: ["B2B Webhooks"]
---

# Update Webhook (v1/v2 cannot be changed; register a new endpoint to switch version)

`PUT /v2/webhooks/{webhook_nanoid}`

## Path parameters

- `webhook_nanoid` string, required

## Request body

- object
  - `url` string, uri
  - `events` string[]
  - `secret` string
  - `is_active` boolean
  - `name` string — Optional display name for the webhook.
  - `description` string — Optional description for the webhook.

## Response `200`

Default Response

- object
  - `success` true, required
  - `data` object, required
    - `webhook_nanoid` string, required — Unique identifier of the Webhook.
    - `webhook_version` 'v1' | 'v2', required — Immutable after registration; same value that was set when the endpoint was created.
    - `url` string, uri, required
    - `events` string[], required
    - `is_active` boolean, required
    - `name` string, nullable, required
    - `description` string, nullable, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/riseworks/apis/b2b-api-v1-legacy.md) · [All operations](https://skmtc.net/riseworks/apis/b2b-api-v1-legacy/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/riseworks/b2b-api-v1-legacy/versions/6f6941749255/schema)