---
title: "Register Webhook Listener"
method: POST
path: "/v2/webhooks/registrations/"
tags: ["webhooks"]
---

# Register Webhook Listener

`POST /v2/webhooks/registrations/`

Register a new Webhook

## Headers

- `Authorization` string, required

## Request body

- RegisterWebhook
  - `webhook_name` string, required
  - `endpoint` string, required

## Response `201`

- RegisterWebhook
  - `webhook_name` string, required
  - `endpoint` string, required

## Changes

- **2026-08-22** `8a237f1f704f` — 2 warning
  - the `endpoint` request property's maxLength was set to `250`
  - the `webhook_name` request property's maxLength was set to `250`

[Change history](https://skmtc.dev/upwardli/apis/api-reference/changes/v2/webhooks/registrations/post.md)

---

[API](https://skmtc.dev/upwardli/apis/api-reference.md) · [All operations](https://skmtc.dev/upwardli/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/upwardli/api-reference/revisions/8a237f1f704f/schema)