# polymorfa webhook

> Inspect and manage developer webhooks.

## Commands

- [polymorfa webhook create](https://docs.polymorfa.com/cli/webhook/create): Create a webhook from one JSON object.
- [polymorfa webhook delete](https://docs.polymorfa.com/cli/webhook/delete): Delete one webhook.
- [polymorfa webhook delivery attempt list](https://docs.polymorfa.com/cli/webhook/delivery-attempt-list): List immutable attempts for a webhook delivery.
- [polymorfa webhook delivery attempt view](https://docs.polymorfa.com/cli/webhook/delivery-attempt-view): View one immutable webhook delivery attempt.
- [polymorfa webhook delivery list](https://docs.polymorfa.com/cli/webhook/delivery-list): List webhook deliveries.
- [polymorfa webhook delivery retry](https://docs.polymorfa.com/cli/webhook/delivery-retry): Append a new immutable attempt to a webhook delivery.
- [polymorfa webhook delivery view](https://docs.polymorfa.com/cli/webhook/delivery-view): View one webhook delivery.
- [polymorfa webhook list](https://docs.polymorfa.com/cli/webhook/list): List webhooks for an explicit resource owner.
- [polymorfa webhook secret rotate](https://docs.polymorfa.com/cli/webhook/secret-rotate): Rotate a webhook signing secret.
- [polymorfa webhook test](https://docs.polymorfa.com/cli/webhook/test): Create a durable synthetic webhook delivery.
- [polymorfa webhook update](https://docs.polymorfa.com/cli/webhook/update): Update a webhook without rotating its secret.
- [polymorfa webhook view](https://docs.polymorfa.com/cli/webhook/view): View one webhook.

## polymorfa webhook create

Create a webhook from one JSON object.

### Usage

```bash
polymorfa webhook create [flags]
```

### Flags

- `--idempotency-key <value>` (value). Use this key to identify retries; one is generated when omitted.
- `--input <value>` (value, required). Read the webhook JSON object from a file or stdin (-).
- `--phone-offline-start-day <value>` (value). First day without the phone on which the webhook receives session.phone_offline (7-13), or off to remove that event. WhatsApp signs the device out on day 14.
- `--secret-out <value>` (value). Write the one-time signing secret to a new mode-0600 file.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa webhook delete

Delete one webhook.

### Usage

```bash
polymorfa webhook delete WEBHOOK [flags]
```

### Arguments

- `WEBHOOK` (required). Webhook ID.

### Flags

- `--idempotency-key <value>` (value). Use this key to identify retries; one is generated when omitted.
- `--yes` (boolean). Confirm the external effect without prompting.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa webhook delivery attempt list

List immutable attempts for a webhook delivery.

### Usage

```bash
polymorfa webhook delivery attempt list DELIVERY [flags]
```

### Arguments

- `DELIVERY` (required). Delivery ID.

### Flags

- `--cursor <value>` (value). Continue from this opaque cursor.
- `--limit <value>` (value). Request this many resources per page. Default: `25`.
- `--max-items <value>` (value). Stop automatic pagination after this many resources.
- `--paginate` (boolean). Request consecutive pages until --max-items resources are collected or no pages remain. Requires --max-items.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa webhook delivery attempt view

View one immutable webhook delivery attempt.

### Usage

```bash
polymorfa webhook delivery attempt view DELIVERY ATTEMPT [flags]
```

### Arguments

- `DELIVERY` (required). Delivery ID.
- `ATTEMPT` (required). Attempt ID.

### Flags

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa webhook delivery list

List webhook deliveries.

### Usage

```bash
polymorfa webhook delivery list [flags]
```

### Flags

- `--cursor <value>` (value). Continue from this opaque cursor.
- `--event <value>` (value). Filter by event ID.
- `--limit <value>` (value). Request this many resources per page. Default: `25`.
- `--max-items <value>` (value). Stop automatic pagination after this many resources.
- `--paginate` (boolean). Request consecutive pages until --max-items resources are collected or no pages remain. Requires --max-items.
- `--since <value>` (value). Include deliveries at or after this RFC 3339 time.
- `--status <value>` (value). Filter by delivery status. Values: `pending`, `delivering`, `retrying`, `succeeded`, `failed`.
- `--until <value>` (value). Exclude deliveries at or after this RFC 3339 time.
- `--webhook <value>` (value). Filter by webhook ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa webhook delivery retry

Append a new immutable attempt to a webhook delivery.

### Usage

```bash
polymorfa webhook delivery retry DELIVERY [flags]
```

### Arguments

- `DELIVERY` (required). Delivery ID.

### Flags

- `--idempotency-key <value>` (value). Use this key to identify retries; one is generated when omitted.
- `--yes` (boolean). Confirm the external effect without prompting.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa webhook delivery view

View one webhook delivery.

### Usage

```bash
polymorfa webhook delivery view DELIVERY [flags]
```

### Arguments

- `DELIVERY` (required). Delivery ID.

### Flags

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa webhook list

List webhooks for an explicit resource owner.

### Usage

```bash
polymorfa webhook list [flags]
```

### Flags

- `--cursor <value>` (value). Continue from this opaque cursor.
- `--limit <value>` (value). Request this many resources per page. Default: `25`.
- `--max-items <value>` (value). Stop automatic pagination after this many resources.
- `--paginate` (boolean). Request consecutive pages until --max-items resources are collected or no pages remain. Requires --max-items.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa webhook secret rotate

Rotate a webhook signing secret.

### Usage

```bash
polymorfa webhook secret rotate WEBHOOK [flags]
```

### Arguments

- `WEBHOOK` (required). Webhook ID.

### Flags

- `--idempotency-key <value>` (value). Use this key to identify retries; one is generated when omitted.
- `--overlap <value>` (value). Keep the previous secret valid for this duration.
- `--secret-out <value>` (value). Write the one-time signing secret to a new mode-0600 file.
- `--yes` (boolean). Confirm the external effect without prompting.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa webhook test

Create a durable synthetic webhook delivery.

### Usage

```bash
polymorfa webhook test WEBHOOK [flags]
```

### Arguments

- `WEBHOOK` (required). Webhook ID.

### Flags

- `--event <value>` (value, required). Synthetic event type.
- `--idempotency-key <value>` (value). Use this key to identify retries; one is generated when omitted.
- `--input <value>` (value). Read optional test input from a file or stdin (-). Project tests accept body and sessionId together; team tests accept only eventType.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa webhook update

Update a webhook without rotating its secret.

### Usage

```bash
polymorfa webhook update WEBHOOK [flags]
```

### Arguments

- `WEBHOOK` (required). Webhook ID.

### Flags

- `--idempotency-key <value>` (value). Use this key to identify retries; one is generated when omitted.
- `--input <value>` (value). Read the webhook update JSON object from a file or stdin (-). Optional with --phone-offline-start-day.
- `--phone-offline-start-day <value>` (value). First day without the phone on which the webhook receives session.phone_offline (7-13), or off to remove that event. WhatsApp signs the device out on day 14.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa webhook view

View one webhook.

### Usage

```bash
polymorfa webhook view WEBHOOK [flags]
```

### Arguments

- `WEBHOOK` (required). Webhook ID.

### Flags

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).
