---
title: "webhooks update"
description: "Update a webhook endpoint"
canonical: "https://pgbeam.com/docs/cli/webhooks/update"
last-updated: "2026-09-14T19:37:21.000Z"
---

# webhooks update

> Update a webhook endpoint

URL: https://pgbeam.com/docs/cli/webhooks/update

Update the configuration of an existing webhook endpoint. Only the fields you provide are changed; current settings are preserved for any flag not specified. Use `--event` to replace the subscribed event types (comma-separated) and `--enabled` to toggle delivery.

## Usage

## Options

Option

Description

Required

Default

`<id>`

ID of the webhook endpoint to update

Yes

-

`--url <value>`

New destination URL for webhook deliveries.

No

-

`--format <value>`

New delivery format: json, splunk\_hec, datadog, or elastic.

No

-

`--event <value>`

Replace subscribed event type(s). Comma-separated.

No

-

`--secret <value>`

New shared secret used to sign webhook payloads.

No

-

`--description <value>`

New human-readable description for the webhook endpoint.

No

-

`--enabled`

Enable (true) or disable (false) the webhook endpoint.

No

-

All global options (`--token`, `--profile`,
`--project`, `--org`, `--json`, `--no-color`, `--no-trunc`, `--debug`) are
also available on this command.

## Examples

## Output

Prints a success message confirming the webhook was updated. With `--json`, returns the full updated webhook object from the API.