Skip to main content

SetAccountProperty

Sets a property on a specific account.

Request

POST /nxt?requestType=set-account-property

All endpoints use port 22024 by default.

Parameters

NameTypeDescriptionRequired
recipientstringAccount ID or SHAMWARI address to modifyYes
propertystringProperty nameYes
valuestringProperty valueYes
secretPhrasestringSender's secret passphraseYes

Response

{
"transaction": "1234567890123456789",
"fullHash": "abc123def456...",
"transactionJSON": {
"type": 2,
"subtype": 5,
"timestamp": 123456789,
"deadline": 14400,
"senderPublicKey": "abc123...",
"amountNQT": "0",
"feeNQT": "100000000",
"signature": "def456...",
"attachment": {
"version.SetAccountProperty": 1,
"recipient": "0987654321",
"property": "my_property",
"value": "my_value"
}
},
"errorCode": 0,
"errorDescription": ""
}

Example

curl -X POST "http://localhost:22024/nxt?requestType=set-account-property" \
-d "recipient=SHAMWARI-ABCD-EFGH-IJKL-MNOPQ" \
-d "property=my_property" \
-d "value=my_value" \
-d "secretPhrase=your_secret_passphrase"