Update users

POST updateSubaccount

To update user's email, use updateSubaccount with the subaccountId from the createSubaccount response.

HTTP request

https://api.changelly.com/v2/#updateSubaccount

Request

Request

Header parameters

Name	Type	Required	Description
X-Api-Key	string	true	Your API key (SHA256 from Public Key)
X-Api-Signature	string	true	The query's serialized body signed by your private key according to the RSA-SHA256 method.

Body parameters

Name	Type	Required	Description
jsonrpc	string	true	JSON-RPC version.
id	string	true	Client's custom ID.
method	string	true	API method name.
params	object	true	Request parameters.

params object:

Name	Type	Required	Description
subaccountId	string	true	subaccountId from the createSubaccount response.
email	string	true	User's email address. Must be unique among all of your users.

Payload

application/json

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "updateSubaccount",
  "params": {
    "subaccountId": "FhbRm-Ox",
    "email": "[email protected]"
  }
}

cURL

curl --location --request POST 'https://api.changelly.com/v2' \
--header 'X-Api-Key: {{apiKey}}' \
--header 'X-Api-Signature: {{sign}}' \
--data-raw '{
  "id": "test",
  "jsonrpc": "2.0",
  "method": "updateSubaccount",
  "params": {
     "subaccountId": "FhbRm-Ox",
     "email": "[email protected]"
  }
}'

Response

Example

Sample response

application/json

{
  "jsonrpc": "2.0",
  "id": "test",
  "result": {
    "subaccountId": "FhbRm-Ox"
  }
}

Success

Response params

Name	Type	Description
jsonrpc	string	JSON-RPC version.
id	string	Client's custom ID.
result	object	Result.

result schema:

Name	Type	Description
subaccountId	string	Subaccount ID.

Errors

Error schema

Name	Type	Description
jsonrpc	string	JSON-RPC version.
id	string	Client's custom ID.
error	object	Possible errors.
»code	integer	Error code.
»message	string	Error message.

Error codes

Code	Message	Description
-32600	Error: You reached requests limit {limit} rps	You have been sending more than 10 requests per second.
-32602	Parameter {param} is invalid	You've specified an invalid parameter. Also, the chance is that the email address is already associated with an existing subaccount.
-32603	Internal Error or Error	Most likely, the problem is on our side. Further investigation is required.