---
title: "Update Webhook"
method: PUT
path: "/webhooks/{id}"
tags: ["Programmatic Webhooks"]
---

# Update Webhook

`PUT /webhooks/{id}`

Update a webhook subscriptions.

## Path parameters

- `id` integer, required

## Request body

- UpdateWebhookRequest
  - `topic` 'return' | 'label' | 'restock' | 'label.request' | 'giftcard' | 'happy.returns.shipment', required — The webhook's topic.
  - `trigger` 'return.created' | 'return.updated' | 'return.closed' | 'label.created' | 'label.updated' | 'restock.requested' | 'label.request.issued' | 'label.request.cancelled' | 'giftcard.requested' | 'shipment.processed', required — The condition which triggers the webhook.
  - `url` string, required — The webhook's URL.
  - `status` 'active' | 'inactive', required — The webhook's status.

## Response `204`

No Content

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable

---

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