---
title: "Register Webhook Event"
method: POST
path: "/webhook/events"
tags: ["Webhooks"]
---

# Register Webhook Event

`POST /webhook/events`

Register a webhook to one or multiple event categories to receive real-time notifications when specific events occur in your application.

## Headers

- `sub-application` string, uuid

## Response `201`

Webhook Details

## Other responses

- `400` — Validation Error
- `401` — Authentication Error
- `406` — Maximum number of registered webhooks has been reached
- `500` — Unexpected Error

---

[API](https://skmtc.net/yapily/apis/yapily-api.md) · [All operations](https://skmtc.net/yapily/apis/yapily-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yapily/yapily-api/versions/a8ca54f9eb9f/schema)