> ## Documentation Index
> Fetch the complete documentation index at: https://docs.msgflash.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POST Créer un webhook

> Crée un endpoint webhook et retourne son secret.

## Endpoint

```txt theme={null}
POST /api/v1/webhooks
```

## Body

| Champ    | Type      | Requis | Description       |
| -------- | --------- | ------ | ----------------- |
| `url`    | string    | oui    | URL de réception  |
| `events` | string\[] | oui    | 1 à 50 événements |

## Réponse succès `201`

```json theme={null}
{
  "data": {
    "id": "wh_uuid",
    "url": "https://example.com/webhooks/msgflash",
    "secret": "generated_once_secret",
    "events": ["message.delivered"],
    "active": true
  }
}
```