# 📖 `clever webhooks` command reference

## ➡️ `clever webhooks` <kbd>Since 0.6.0</kbd>

Manage webhooks

```bash
clever webhooks [options]
```

### ⚙️ Options

|Name|Description|
|---|---|
|`-F`, `--format` `<format>`|Output format (human, json) (default: human)|
|`--list-all`|List all notifications for your user or for an organisation with the '--org' option|
|`-o`, `--org`, `--owner` `<org-id\|org-name>`|Organisation to target by its ID (or name, if unambiguous)|

## ➡️ `clever webhooks add` <kbd>Since 0.6.0</kbd>

Register webhook to be called when events happen

```bash
clever webhooks add <name> <url> [options]
```

### 📥 Arguments

|Name|Description|
|---|---|
|`name`|Notification name|
|`url`|Webhook URL|

### ⚙️ Options

|Name|Description|
|---|---|
|`--event` `<event-type>`|Restrict notifications to specific event types|
|`--format` `<format>`|Format of the body sent to the webhook ('raw', 'slack', 'gitter', or 'flowdock') (default: raw)|
|`-o`, `--org`, `--owner` `<org-id\|org-name>`|Organisation to target by its ID (or name, if unambiguous)|
|`--service` `<service-id>`|Restrict notifications to specific applications and add-ons (requires --org)|

## ➡️ `clever webhooks remove` <kbd>Since 0.6.0</kbd>

Remove an existing webhook

```bash
clever webhooks remove <notification-id> [options]
```

### 📥 Arguments

|Name|Description|
|---|---|
|`notification-id`|Notification ID|

### ⚙️ Options

|Name|Description|
|---|---|
|`-o`, `--org`, `--owner` `<org-id\|org-name>`|Organisation to target by its ID (or name, if unambiguous)|