---
title: "Register new webhook"
method: POST
path: "/hooks"
tags: ["Webhooks"]
---

# Register new webhook

`POST /hooks`

Register a new webhook which will be called on a specific event. See the WebhookCallback model. (Permitted scopes: **fax:all:edit**, **fax:webhook:edit**)

## Request body

- Webhook — Webhook model
  - `id` string — Webhook ID
  - `target` string, required — Webhook target URL
  - `event` 'fax_received' | 'fax_sent' | 'fax_page_received', required — Webhook event type
  - `numbers` string[], nullable — A list of phone numbers used to filter webhook triggers. If specified, the webhook will only fire for inbound or outbound calls involving these numbers. Pass null to disable filtering. An empty array is invalid

## Response `200`

Webhook ID

- WebhookId — Webhook ID
  - `id` string, required — Webhook ID

## Other responses

- `400` — Error object in case there's a problem with given data
- `500` — Error object in case there's a server error

---

[API](https://skmtc.net/fax/apis/fax-plus-rest-api.md) · [All operations](https://skmtc.net/fax/apis/fax-plus-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fax/fax-plus-rest-api/revisions/c1afc85d2c15/schema)