# POST /api/webhooks/{id}/toggle

> Webhooks - Enable or Disable a Webhook

Flips the enabled flag. Send an explicit value in the body to set it instead of flipping it. A disabled webhook keeps its configuration, its secret and its delivery history, but receives nothing: it stops producing new queued deliveries at once, and anything already queued for it is discarded rather than sent when the cron job next runs.

- **Endpoint:** `POST /api/webhooks/{id}/toggle`
- **Group:** Webhooks
- **Since:** v1.0.0
- **Defined in:** `RestApi/Controllers/WebhooksController.php`

## Headers

| Field | Type | Description |
| --- | --- | --- |
| `authtoken` | String | Authentication token, generated from admin area |

## Parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | Number | yes | Webhook unique ID |
| `active` | Number | no | Optional 1 to enable, 0 to disable. Omit it to flip the current value |

## Request example

```bash
curl -X POST "https://yoursite.com/index.php/api/webhooks/123/toggle" \
  -H "authtoken: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "field": "value" }'
```

## Responses

### Success - Success-Response:

```json
HTTP/1.1 200 OK
{
  "status": 200,
  "messages": { "success": "Record saved" },
  "active": 0,
  "data": { "id": 3, "name": "Ops sync", "active": 0, "has_secret": true }
}
```

### Error - Error-Response:

```json
HTTP/1.1 404 Not Found
{ "status": false, "messages": { "error": "No data were found" } }
```

---

Part of the [REST API for RISE CRM](https://risecrm.themesic.com/apiguide/) documentation.
Full page: https://risecrm.themesic.com/apiguide/webhooks/toggle-webhook/