v1

latestOpenAPI 3.0.32026-07-1320201.0 MB

Tron Webhooks

Create webhook

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

post/api/v2/tron/webhooks

Headers

X-Network'testnet' | 'mainnet'

Specify "testnet" for test network or leave empty for main network. Defaults to "mainnet" if not provided.

Authorizationstring required

Bearer token for authorization. Required for authenticated endpoints.

Content-Type'application/json' | 'application/x-www-form-urlencoded' | 'multipart/form-data' required

The MIME type of the request body.

Request body

fromstring

The sender Tron address

tostring

The receiver Tron address

urlstring required

URL for webhook notifications (required). Must be a valid URL.

contractaddressstring

token_idstring

This field is required when none of <code>from</code> and <code>to</code> are present.

type'TRX' | 'TRC10' | 'TRC20' | 'TRC721'

referencestring nullable

A reference for the webhook. Must not be greater than 255 characters.

Example request

{
  "from": "TWrTTVizHkF3LxTiWE9vCnhWC7CBpNXe22",
  "to": "TWrTTVizHkF3LxTiWE9vCnhWC7CBpNXe22",
  "url": "http://vonrueden.com/",
  "contractaddress": "TWrTTVizHkF3LxTiWE9vCnhWC7CBpNXe22",
  "type": "TRC20",
  "reference": "n"
}

Response

statusinteger

okboolean

messagestring

Example response

{
  "status": 201,
  "ok": true,
  "message": "Webhook created",
  "data": {
    "webhook": "9b2b4dcc-1479-4bcd-9b8a-015673e80f46"
  }
}