---
title: "Create webhook"
method: POST
path: "/api/v2/tron/webhooks"
tags: ["Tron Webhooks"]
---

# Create webhook

`POST /api/v2/tron/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 — The sender Tron address
  - `to` string — The receiver Tron address
  - `url` string, required — URL for webhook notifications (required). Must be a valid URL.
  - `contractaddress` string
  - `token_id` string — This field is required when none of <code>from</code> and <code>to</code> are present.
  - `type` 'TRX' | 'TRC10' | 'TRC20' | 'TRC721'
  - `reference` string, nullable — A reference for the webhook. Must not be greater than 255 characters.

## 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)