---
title: "Register a webhook endpoint"
method: POST
path: "/api/v1/webhooks"
---

# Register a webhook endpoint

`POST /api/v1/webhooks`

## Request

- Base URL: `https://deskcrew.io`
- URL: `https://deskcrew.io/api/v1/webhooks`
- Auth: HTTP bearer

The URL must be public https. Private, loopback, link-local and metadata addresses are rejected at write time and again at send time. Requires the `webhooks:manage` scope.

## Request body

- object: url: string, required, https; events: string[], required

## Response `200`

Success

## Other responses

- `401`: Missing or invalid API key
- `403`: The key does not hold the required scope
- `404`: Not found in this workspace
- `429`: Rate limited

---

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