---
api: 'Business API'
---

# Update a webhook

Update an existing webhook. Change the URL to which event notifications are sent or the list of event types to be notified about.

You must specify at least one of these two. The fields that you don't specify are not updated.

For more information, see the guides: [About webhooks](/docs/guides/manage-accounts/webhooks/about-webhooks) and [Manage webhooks](/docs/guides/manage-accounts/webhooks/manage-webhooks#update-a-webhook).

## Endpoint

PATCH `/webhooks/{webhook_id}`

## Parameters

### path parameters

- `webhook_id` (string, required)
  The ID of the webhook to update.

## Request body

The new webhook URL for the given webhook

### Attributes

- `url` (string, optional)
    A valid webhook URL to which to send event notifications. The supported protocol is `https`.
- `events` (array of enum, optional)
    A list of event types to subscribe to.

## Returns

### 200

The successfully updated webhook

#### Response attributes

- `id` (string)
    The ID of the webhook.
- `url` (string)
    The valid webhook URL that event notifications are sent to. The supported protocol is `https`.
- `events` (array of enum)
    The list of event types that you are subscribed to.

## Error responses

| HTTP status code | Description |
| --- | --- |
| 400 | Bad Request |