# Overview

Webhooks deliver real-time event notifications to your server via HTTP POST requests.

## How It Works

1. Register a webhook URL and subscribe to events
2. When events occur, TokenBot sends a signed HTTP POST to your URL
3. Your server responds with `2xx` to acknowledge receipt
4. Failed deliveries are retried with exponential backoff

## Quick Start

```bash
# Create a webhook
curl -X POST https://rest-api.tokenbot.com/v1/webhooks \
  -H "X-API-Key: tb_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-server.com/webhooks",
    "events": ["trade.filled", "copier.started", "copier.stopped"]
  }'
```

## Documentation

* [Management](https://docs.tokenbot.com/home/api-docs/webhooks/management) — Create, update, delete, test webhooks
* [Events](https://docs.tokenbot.com/home/api-docs/webhooks/events) — All 27 event types with payloads
* [Security](https://docs.tokenbot.com/home/api-docs/webhooks/security) — Signature verification
* [Delivery](https://docs.tokenbot.com/home/api-docs/webhooks/delivery) — Retry logic and dead letter queue