POST https://api.cryptohopper.com/v1/user/email

Starts a change of the user's email address. The user gets a confirmation email at the old and at the new address and must confirm both. One request per hour is allowed.

OAuth scope: user About scopes

code is the user's current two-factor code and may not be empty. Accounts without two-factor authentication accept any non-empty value. An address that already belongs to another account is refused.

Example request

curl -X POST "https://api.cryptohopper.com/v1/user/email" \
  -H "access-token: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","code":"123456"}'

Parameters

Headers

NameTypeRequiredDescription
access-token string Required The OAuth access token of the user.

Request body

JSON, model UserEmailPost

FieldTypeRequiredDescription
emailstringOptional

Response

Example response (illustrative values)

{
    "data": "E-mail address change request initiated."
}

Status codes: 200. Errors return JSON with status, error and message. See How the API works for response codes and rate limits.