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

# webhooks create

> Create a webhook endpoint

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

Create a webhook endpoint for the linked project. PgBeam delivers event and audit notifications to the given URL using the selected format. Subscribe to specific event types with `--event` (repeatable or comma-separated); omit it to receive all events.

## Usage

## Options

Option

Description

Required

Default

`<url>`

Destination URL for webhook deliveries. If omitted, you will be prompted.

No

-

`--format <value>`

Delivery format: json, splunk\_hec, datadog, or elastic.

No

`json`

`--event <value>`

Event type(s) to subscribe to. Comma-separated. Omit to receive all events.

No

-

`--secret <value>`

Shared secret used to sign webhook payloads.

No

-

`--description <value>`

Human-readable description for the webhook endpoint.

No

-

`--disabled`

Create the webhook in a disabled state.

No

`false`

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 with the new webhook ID and its URL. With `--json`, returns the full webhook object from the API.