# Managing Webhooks

Webhook records are managed through the Admin API `client_webhooks` service. For the full parameter and schema details see the [ClientWebhook reference](/admin-api/clientwebhook).

## Create a webhook

Creates a new webhook with an address and topic.

```http
POST https://your-store.myideasoft.com/admin-api/client_webhooks
```

Request body:

```json
{
  "topic": "product/create",
  "address": "https://your-app.example.com/webhook",
  "status": 1
}
```

Response:

```json
{
  "id": 1,
  "client": {
    "id": 1,
    "name": "Sendloop"
  },
  "topic": "product/create",
  "address": "https://your-app.example.com/webhook",
  "status": 1,
  "createdAt": "2022-07-26T10:59:04+03:00",
  "updatedAt": "2022-07-26T10:59:04+03:00"
}
```

## List webhooks

```http
GET https://your-store.myideasoft.com/admin-api/client_webhooks
```

Response:

```json
[
  {
    "id": 1,
    "client": { "id": 1, "name": "Sendloop" },
    "topic": "product/create",
    "address": "https://your-app.example.com/webhook",
    "status": 1,
    "createdAt": "2022-07-26T10:58:54+03:00",
    "updatedAt": "2022-07-26T10:58:54+03:00"
  },
  {
    "id": 2,
    "client": { "id": 1, "name": "Sendloop" },
    "topic": "payment/create",
    "address": "https://your-app.example.com/webhook",
    "status": 1,
    "createdAt": "2022-07-26T11:05:21+03:00",
    "updatedAt": "2022-07-26T11:05:21+03:00"
  }
]
```

## Update a webhook

```http
PUT https://your-store.myideasoft.com/admin-api/client_webhooks/{webhook_id}
```

Request body:

```json
{
  "topic": "product/create",
  "address": "https://your-app.example.com/webhook",
  "status": 1
}
```

The response is the updated webhook record.

## Delete a webhook

Permanently deletes the webhook.

```http
DELETE https://your-store.myideasoft.com/admin-api/client_webhooks/{webhook_id}
```

A successful delete returns `204 No Content` with no response body.

:::warning{title="fields"}
The `fields` property seen in examples of older documentation **was removed in V8** — do not include it in request bodies.
:::
