---
title: "webhook modify"
slug: "webhook-modify"
tags: ["5.5"]
updated: 2026-10-27T23:00:54Z
published: 2026-10-27T23:00:54Z
canonical: "docs.vastdata.com/webhook-modify"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vastdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# webhook modify

This command modifies a webhook.

## Usage

```plaintext
webhook modify --id ID
               [--name TEXT]
               [--url URL]
               [--method {POST|PUT|PATCH|DELETE|GET}]
               [--data JSON]
               [--headers HEADERS]
               [--enable|--disable]
               [--certificate-id ID]
```

## Required Parameters

| `--id ID` | The ID of the webhook you want to modify. |
| --- | --- |

## Options

| `--name TEXT` | A name for the webhook. |
| --- | --- |
| `--url URL` | The URL of the external application. |
| `--method {POST\|PUT\|PATCH\|DELETE\|GET}` | The HTTP method to be used when the notification is sent to the external application. |
| `--data JSON` | The data to be sent as the webhook message to the external application, in JSON format. For example: ​​`--webhook-data '"event":"$vastdata_event_name"'​` For information about variables that can be used within the JSON data, see [Variables in Webhook Data](/docs-5-5/docs/managing-webhooks#variables-in-webhook-data1). |
| `--headers HEADERS` | Custom HTTP headers to be included into the message sent to the external application. You can add as many custom headers as necessary. Specify HEADERS as a comma-separated list of key-value pairs (`key1=value1,key2=value2`) where each key is the name of the header you want to add. |
| `--enable` | Enables the webhook. |
| `--disable` | Disables the webhook. |
| `--certificate-id ID` | The ID of the certificate used to secure the connection to the external application with TLS. The certificate must be uploaded to the VMS beforehand using the `certificate add --cert-type WEBHOOK` command. |

## Example

To disable a webhook:

```plaintext
webhook modify --id 14 --disable
```