Send message

Sends a serialized external message (BOC) to the TON network for processing. The message must be a valid base64-encoded bag-of-cells. Returns the message hash on success.

POST /api/v3/message

Send message

cURL

curl --request POST \
  --url https://toncenter.com/api/v3/message \
  --header 'Content-Type: application/json' \
  --data '
{
  "boc": "<string>"
}
'

200

{
  "message_hash": "<string>",
  "message_hash_norm": "<string>"
}

Body

application/json

Request body for sending an external message to the TON network. The boc field must contain a valid serialized external message in base64-encoded BOC format, including the destination address and a valid signature.

boc · string

Serialized external message in BOC format, base64 encoded. Must contain a valid destination address, signature, and message body.

Response

200

application/json

Message hash of the submitted external message.

Result of successfully submitting an external message. Contains the message hash (for looking up the message) and the normalized hash (stable across re-serializations).

message_hash · string

Hash of the submitted message, hex encoded. Use this to track the message status via the messages or traces endpoints.

message_hash_norm · string

Normalized hash of the submitted message, stable across re-serializations. Use this for reliable message lookups.