> For the complete documentation index, see [llms.txt](https://doc.var-fivem.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.var-fivem.com/coins-shop/configuration/webhooks-discord.md).

# Webhooks (Discord)

Var Coins Shop can send rich Discord embeds for nearly every event of the shop lifecycle. Configured in `shared/config.lua` under `Shop.Webhooks`.

### Base configuration

```lua
Webhooks = {
  Enabled = true,
  Url = "https://discord.com/api/webhooks/your-webhook-url",
  Username = "Var Coins Shop",
  AvatarUrl = "https://example.com/avatar.png",
  Footer = "Var FiveM Shop Webhook",
}
```

Set `Enabled = false` to disable all webhooks globally.

### Per-event toggle

Each event can be toggled individually:

```lua
Events = {
  -- Player-triggered
  checkout = true,        -- Shop purchase completed
  balance = true,         -- Balance changed (add/remove)
  delivery = true,        -- Item delivered to a player
  topupIntent = true,     -- Player opened the Tebex page
  accountCreated = true,  -- New account created
  localeUpdate = true,    -- Player changed language

  -- Owner panel
  ownerPromo = true,
  ownerStock = true,
  ownerRotation = true,
  ownerMaintenance = true,
  ownerSpotlight = true,
  ownerAnnouncement = true,
  ownerTheme = true,
  ownerWebhook = true,
}
```

### Embed examples

* **Checkout** — green embed listing the items, total spent, balance after, applied promo code.
* **Delivery** — blue embed listing the delivered items.
* **Owner action** — amber embed with the action and the actor identifier.

### Runtime override (owner panel)

An authorized owner can change the webhook URL **at runtime** from the in-game owner panel without editing the config file. See In-game owner panel.