# Webhook

> Shoplazza AI Toolkit prompts for the shoplazza-webhook skill: subscribe to store events, list and count subscriptions, change a callback URL, delete one.

Natural-language prompts for the `shoplazza-webhook` skill — event subscriptions for your app. Prefix each request with `/shoplazza-webhook`, then describe the task.

## Prerequisites

* [Get started](../get-started)
* Authenticate against your store: `shoplazza auth login --store-domain <domain> --domain webhook`

## Examples

### 1. Subscribe to an event

```
/shoplazza-webhook Subscribe to the orders/create event and send it to https://example.com/hook
```

Runs `webhook create` with topic `orders/create` and that address.

### 2. List subscriptions

```
/shoplazza-webhook What webhooks are registered right now?
```

Runs `webhook list --format table`.

### 3. Update a callback URL

```
/shoplazza-webhook Change webhook 123 to point at https://example.com/webhooks/orders-v2
```

Runs `webhook update --params '{"webhook_id":"123"}'` with the new address.

### 4. Delete a subscription

```
/shoplazza-webhook Remove webhook 123
```

Runs `webhook delete --params '{"webhook_id":"123"}'`. As a write operation, the agent previews with `--dry-run` and confirms first.

### 5. Count subscriptions

```
/shoplazza-webhook How many webhooks do I have?
```

Runs `webhook count`.

## Domain boundary

This skill owns the **subscription**. The events themselves (order created, product updated) are produced by the `orders` and `products` domains.

## See also

* [Shoplazza CLI: webhook commands](/docs/app/developer-tools/shoplazza-cli/commands/webhook)
* [Webhook overview](/docs/app/building-blocks/webhooks/overview)