---
title: "Create Webhook"
method: POST
path: "/api/webhooks"
tags: ["webhooks"]
---

# Create Webhook

`POST /api/webhooks`

## Request

- Base URL: `https://outsend.xyz`
- URL: `https://outsend.xyz/api/webhooks`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Enregistre un endpoint. Le secret n'est renvoyé QU'ICI — le stocker
côté consommateur pour vérifier X-Outsend-Signature.

## Request body

- WebhookCreateRequest
  - `url` string, required: URL https:// publique qui recevra les POST
  - `events` string[], required: Types d'événements souscrits
  - `secret` string, nullable: Secret HMAC. Généré si absent.

## Response `201`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/outsend/apis/outsend-api.md) · [All operations](https://skmtc.dev/outsend/apis/outsend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/outsend/apis/outsend-api/revisions/39db3c6f886a?raw)