---
title: "Create a new Webhook"
method: POST
path: "/api/v2/bitcoin/webhooks"
tags: ["Bitcoin Webhooks"]
---

# Create a new Webhook

`POST /api/v2/bitcoin/webhooks`

Creates a new webhook for real-time communication and event notification.

## Headers

- `X-Network` 'testnet' | 'mainnet'
- `Authorization` string, required
- `Content-Type` 'application/json' | 'application/x-www-form-urlencoded' | 'multipart/form-data', required

## Request body

- object
  - `from` string — Sender address (required if not providing type, to, contractaddress, and tokenid). This field is required when none of <code>type</code>, <code>to</code>, <code>contractaddress</code>, and <code>tokenid</code> are present.
  - `to` string — Receiver address (required if not providing type, from, contractaddress, and tokenid). This field is required when none of <code>from</code>, <code>type</code>, <code>contractaddress</code>, and <code>tokenid</code> are present.
  - `url` string, required — URL for webhook notifications (required).

## Response `201`

- object
  - `status` integer
  - `ok` boolean
  - `message` string
  - `data` object
    - `webhook` string

## Other responses

- `422`

---

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