PUT
/
core
/
accounts
/
{accountId}
/
deposit-method
Set up account deposit method
curl --request PUT \
  --url https://api.enterprise.sandbox.uphold.com/core/accounts/{accountId}/deposit-method \
  --header 'Authorization: Bearer <token>'
{
  "depositMethod": {
    "type": "crypto",
    "status": "ok",
    "details": {
      "asset": "BTC",
      "network": "bitcoin",
      "address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"
    }
  }
}
Use this endpoint to initiate the setup of a deposit method for an account. You can check which assets support deposits by calling the List Assets endpoint and filtering for assets that have deposit included in their features. Once you select an asset, you can determine the supported networks by calling the List Rails endpoint for that asset and filtering for rails that also include deposit in their features. For more details, refer to the Assets section.

​
Asynchronous Setup Process

Some deposit methods require an asynchronous setup process depending on the network.
  • Calling this endpoint for the first time will trigger the setup of the underlying deposit method.
  • If the deposit method is not immediately available, you can use the Get Account Deposit Method endpoint with the same inputs to check the deposit method state.
If the deposit method is already set up, calling this endpoint again with the same inputs will not trigger a new setup process and instead will return the existing deposit method.

Authorizations

​
Authorization
string
header
required

OAuth 2.0 authentication.

Path Parameters

​
accountId
string<uuid>
required

The account id.

Query Parameters

​
type
enum<string>
required

The type of the deposit method.

Available options:
crypto,
bank
​
asset
string
required

The asset to use for the deposit.

​
network
string
required

The network to use for the deposit.

Response

200
application/json

Deposit method set up.

The response is of type object.