---
title: "Update an existing webhook"
method: PUT
path: "/webhooks/{webhookId}"
tags: ["Webhooks"]
---

# Update an existing webhook

`PUT /webhooks/{webhookId}`

Updates an existing webhook using the webhook object ID.

## Path parameters

- `webhookId` string, required

## Request body

- WebhookUpdateRequest
  - `event` 'transaction_created' | 'transaction_updated' | 'track_updated' | 'batch_created' | 'batch_purchased' | 'all', required — Type of event that triggered the webhook.
  - `url` string, required — URL webhook events are sent to.
  - `active` boolean — Determines whether the webhook is active or not.
  - `is_test` boolean — Determines whether the webhook is a test webhook or not.

## Response `200`

Webhook

- Webhook
  - `event` string, required — Type of event that triggers the webhook.
  - `url` string, required — URL webhook events are sent to.
  - `active` boolean — Determines whether the webhook is active or not.
  - `is_test` boolean — Determines whether the webhook is a test webhook or not.
  - `object_created` string, date-time — Timestamp of the creation of the webhook.
  - `object_id` string — Unique identifier of the webhook. This can be used to retrieve or delete the webhook.
  - `object_updated` string, date-time — Timestamp of the last update of the webhook.
  - `object_owner` string — Username of the user who created the webhook.

---

[API](https://skmtc.net/goshippo/apis/shippo-external-api.md) · [All operations](https://skmtc.net/goshippo/apis/shippo-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/goshippo/shippo-external-api/revisions/13280a44853c/schema)