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

# Update Webhook

`PUT /v1/webhooks/{id}`

Update a webhook.
You can update the endpoint url, event types that the endpoint receives, or temporarily deactivate the webhook.

## Path parameters

- `id` string, required

## Request body

- UpdateWebhookSubscriptionRequest
  - `url` string, required — The URL to which webhook events will be sent. Must be a valid HTTPS URL.
  - `group_id` string, nullable — ID of the webhook group to which this subscription applies, if any. This is only available for partners.
  - `event_types` WebhookEventType[], required — A list of the webhook event types this subscription will listen to.
  - `status` 'ACTIVE' | 'INACTIVE', required — The status to set for this webhook subscription.

## Response `200`

Success

- WebhookSubscription — A webhook subscription. When events of the specified event types occur, they will be sent to the given URL. If the subscription applies to a webhook group, then only events that apply to the members of that group will be sent. If it does not apply to any group, then only events that don't apply to any specific group will be sent. Webhook groups are only available for partners.
  - `id` string, required — ID of the webhook subscription.
  - `group_id` string, nullable — ID of the webhook group to which this subscription applies, if any.
  - `url` string, required — The URL to which webhook events will be sent. Must be a valid HTTPS URL.
  - `event_types` WebhookEventType[], required — List of event types that this webhook subscription listens to.
  - `status` 'ACTIVE' | 'INACTIVE', required — The status of this webhook subscription.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal server error

---

[API](https://skmtc.net/brex-com/apis/webhooks-api.md) · [All operations](https://skmtc.net/brex-com/apis/webhooks-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brex-com/webhooks-api/revisions/bc197ebb855c/schema)