---
title: "Update a webhook"
method: PUT
path: "/admin/webhooks/{webhook_id:(?:\\\\d+)}.json"
tags: ["Webhook"]
---

# Update a webhook

`PUT /admin/webhooks/{webhook_id:(?:\\d+)}.json`

Update a webhook subscription's topic or address URIs

## Request body

- WebhookSwaggerResponse
  - `webhook` Webhook
    - `address` string — URI where the webhook subscription should send the POST request when the event occurs.
    - `created_at` integer — Date and time when the webhook subscription was created. The API returns this value in [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601).
    - `fields` string[] — Optional array of fields that should be included in the webhook subscription.
    - `format` string — Format in which the webhook subscription should send the data. Valid values are `JSON` and `XML`.
    - `id` integer — Unique numeric identifier for the webhook subscription.
    - `metafield_namespaces` string[] — Optional array of namespaces for any metafields that should be included the webhook subscription.
    - `topic` string — Event that triggers the webhook. Valid values are: app/uninstalled, carts/create, carts/update, checkouts/create, checkouts/delete, checkouts/update, collection_listings/add, collection_listings/remove, collection_listings/update, collections/create, collections/delete, collections/update, customer_groups/create, customer_groups/delete, customer_groups/update, customers/create, customers/delete, customers/disable, customers/enable, customers/update, draft_orders/create, draft_orders/delete, draft_orders/update, fulfillment_events/create, fulfillment_events/delete, fulfillments/create, fulfillments/update, order_transactions/create, orders/cancelled, orders/create, orders/delete, orders/fulfilled, orders/paid, orders/partially_fulfilled, orders/updated, product_listings/add, product_listings/remove, product_listings/update, products/create, products/delete, products/update, refunds/create, shop/update, themes/create, themes/delete, themes/publish, themes/update, inventory_levels/connect, inventory_levels/update, inventory_levels/disconnect, inventory_items/create, inventory_items/update, inventory_items/delete, locations/create, locations/update, locations/delete, tender_transactions/create
    - `updated_at` integer — Date and time when the webhook subscription was updated. The API returns this value in [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601).

## Response `200`

OK

- WebhookSwaggerResponse
  - `webhook` Webhook
    - `address` string — URI where the webhook subscription should send the POST request when the event occurs.
    - `created_at` integer — Date and time when the webhook subscription was created. The API returns this value in [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601).
    - `fields` string[] — Optional array of fields that should be included in the webhook subscription.
    - `format` string — Format in which the webhook subscription should send the data. Valid values are `JSON` and `XML`.
    - `id` integer — Unique numeric identifier for the webhook subscription.
    - `metafield_namespaces` string[] — Optional array of namespaces for any metafields that should be included the webhook subscription.
    - `topic` string — Event that triggers the webhook. Valid values are: app/uninstalled, carts/create, carts/update, checkouts/create, checkouts/delete, checkouts/update, collection_listings/add, collection_listings/remove, collection_listings/update, collections/create, collections/delete, collections/update, customer_groups/create, customer_groups/delete, customer_groups/update, customers/create, customers/delete, customers/disable, customers/enable, customers/update, draft_orders/create, draft_orders/delete, draft_orders/update, fulfillment_events/create, fulfillment_events/delete, fulfillments/create, fulfillments/update, order_transactions/create, orders/cancelled, orders/create, orders/delete, orders/fulfilled, orders/paid, orders/partially_fulfilled, orders/updated, product_listings/add, product_listings/remove, product_listings/update, products/create, products/delete, products/update, refunds/create, shop/update, themes/create, themes/delete, themes/publish, themes/update, inventory_levels/connect, inventory_levels/update, inventory_levels/disconnect, inventory_items/create, inventory_items/update, inventory_items/delete, locations/create, locations/update, locations/delete, tender_transactions/create
    - `updated_at` integer — Date and time when the webhook subscription was updated. The API returns this value in [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601).

---

[API](https://skmtc.net/shopbase/apis/shopbase-internal-api.md) · [All operations](https://skmtc.net/shopbase/apis/shopbase-internal-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shopbase/shopbase-internal-api/revisions/353ccde6240d/schema)