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

# Create Webhook

`POST /Webhooks`

## Request

- Base URL: `https://api.younium.com`
- URL: `https://api.younium.com/Webhooks`
- Auth: OAuth 2 (password, token URL `https://auth.younium.com/connect/token`, scopes: `youniumapi`)

## Headers

- `api-version` string
- `younium-idempotency-key` string
- `younium-idempotency-durationInHours` integer

## Request body

- CreateWebhookRequest
  - `url` string, uri, required
  - `events` string[], required
  - `description` string, nullable
  - `webhookStatus` 'Enabled' | 'Disabled'

## Response `201`

Created

- WebhookModel
  - `id` string, uuid
  - `url` string, nullable
  - `events` string[], nullable
  - `token` string, nullable
  - `description` string, nullable
  - `webhookStatus` 'Enabled' | 'Disabled'

## Other responses

- `400`: Bad Request.
- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/younium/apis/younium-api-production-westeurope.md) · [All operations](https://skmtc.dev/younium/apis/younium-api-production-westeurope/llms.txt) · [OpenAPI document](https://skmtc.dev/younium/apis/younium-api-production-westeurope/revisions/d055582b6276?raw)