---
title: "Update webhook"
method: PUT
path: "/v2/api/webhooks/{webhook_id}"
tags: ["Webhooks"]
---

# Update webhook

`PUT /v2/api/webhooks/{webhook_id}`

Updates a webhook endpoint. Only the fields you provide are changed. Omitted fields are left untouched.

## Path parameters

- `webhook_id` string, required

## Request body

- UpdateWebhookApiRequest — All fields optional. Only the fields you provide are changed.
  - `url` string, uri — New HTTPS delivery URL.
  - `topics` WebhookTopic[] — Replacement set of event topics.
  - `description` string — New label.
  - `enabled` boolean — Enable or disable the endpoint.

## Response `200`

Webhook updated

- object
  - `data` WebhookApiResponse — A webhook endpoint.
    - `id` string — Unique webhook endpoint ID.
    - `url` string, uri — HTTPS URL that receives event deliveries.
    - `topics` WebhookTopic[] — Event topics this endpoint is subscribed to.
    - `description` string, nullable — Optional human-readable label.
    - `enabled` boolean — Whether the endpoint is active.
    - `signing_secret` string, nullable — Secret used to verify delivery signatures. Returned only when the webhook is created or fetched by ID.
    - `created_at` string, date-time, nullable — When the endpoint was created.

## Other responses

- `400` — Invalid request parameters
- `401` — Invalid or missing API key
- `404` — Resource not found
- `429` — Rate limit exceeded

---

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