Create a new Subaccount

Create a new Subaccount using the data provided in the request body.

POST /v1/accounts/subaccounts

Create a new Subaccount

cURL

curl --request POST \
  --url https://sandbox-api.borderless.xyz/v1/accounts/subaccounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "identityId": "cm9db4g2s2r7ro224ra6u1qvl",
  "name": "Main Account",
  "assets": [
    {
      "asset": "ETH",
      "address": "0xE79a68B87544ed42Cc5aA805bb056201e7942D3A"
    }
  ]
}
'

201

{
  "id": "<string>",
  "type": "web3",
  "pfi": "Bridge",
  "web3Provider": "Utila",
  "name": "<string>",
  "addresses": [
    {
      "id": "<string>",
      "asset": "POL",
      "address": "<string>"
    }
  ],
  "assets": [
    {
      "id": "<string>",
      "asset": "POL",
      "address": "<string>"
    }
  ],
  "fiats": [
    {
      "id": "<string>",
      "fiat": "USD"
    }
  ],
  "identityId": "<string>",
  "createdAt": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Standalone Subaccount

Dfns Subaccount

Utila Subaccount

identityId · string · required

The id of the identity associated with the account. Learn more at Identity Guide.

Required string length: 25

Example:

"cm9db4g2s2r7ro224ra6u1qvl"

name · string · required

A unique identifier for your account, allowing you to distinguish it from other accounts.

Required string length: 3 - 50

Example:

"Main Account"

assets · object[]

An array of assets associated with blockchain addresses. Refer to the Own Managed Address Documentation.

Show child attributes

Response

201

application/json

Successfully created Subaccount data.

id · string · required

type · enum<string> · required

Available options: web3, pfi

pfi · enum<string> · required

Available options: Bridge, Koywe, Kotanipay, Hercle, Bitso, Yellowcard, TraceFinance, HoneyCoin, BlindPay, Finity, Infinia, Walapay, Abra, Yativo, Capa, Bivo, Cobre, Avenia, Brale, BVNK, CoinsPH, Iron, Enigma, Juicyway, Kira, TripleA, Onmeta

web3Provider · enum<string> · required

Available options: Utila, Standalone, MultiProvider, Dfns, NotApplicable

name · string · required

addresses · object[] · required · deprecated

Deprecated. Will be removed by May 1st, 2026. Use the assets and fiats properties instead for retrieving account asset and fiat details.

Show child attributes

assets · object[] · required

Show child attributes

fiats · object[] · required

Show child attributes

identityId · string · required

createdAt · string<date-time> · required