---
title: "Register webhook"
method: POST
path: "/webhooks"
tags: ["webhooks"]
---

# Register webhook

`POST /webhooks`

Registers a new webhook with the specified callback URL and event scopes.

## Request body

- RegisterWebHookRequest
  - `callbackURL` string, uri, required — URL that will receive webhook event POST requests.
  - `scopes` string[], required — Event scopes to subscribe to.

## Response `200`

Webhook registered.

- Webhook
  - `id` integer, required — Unique identifier of the webhook.
  - `callbackURL` string, uri, required — URL that receives webhook event POST requests.
  - `secretKey` string, required — Secret key used for webhook request authentication via HTTP Basic Auth.
  - `scopes` string[], required — Event scopes the webhook is subscribed to.

---

[API](https://skmtc.dev/siafoundation/apis/hostd-api.md) · [All operations](https://skmtc.dev/siafoundation/apis/hostd-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/siafoundation/hostd-api/revisions/08ff756929fc/schema)