Create Account

Create an account

POST /accounts

Create Account

cURL

curl --request POST \
  --url https://mapi.zbx.boomfi.xyz/v1/accounts \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "currencies": [
    "USDC",
    "ETH"
  ],
  "reference": "treasury",
  "type": "CryptoPayIn",
  "address": "<string>",
  "chain_id": 8453,
  "name": "Treasury",
  "parent_account_id": "42"
}
'

200

{
  "data": {
    "account_number": [
      "<string>"
    ],
    "address": "<string>",
    "chain": {
      "id": 123,
      "name": "<string>",
      "native_currency_symbol": "<string>"
    },
    "chain_id": 123,
    "created_at": "<string>",
    "created_by": "<string>",
    "currencies": [
      "<string>"
    ],
    "deleted_at": "<string>",
    "deposit_splits": [
      {
        "account_id": 123,
        "account_ref": "<string>",
        "address": "<string>",
        "pct": "<string>"
      }
    ],
    "enabled": true,
    "id": 123,
    "name": "<string>",
    "org_id": "<string>",
    "parent": "<unknown>",
    "parent_id": 123,
    "payin_fee_pct": 123,
    "payout_fee_pct": 123,
    "properties": {},
    "reference": "<string>",
    "sort_code": [
      "<string>"
    ],
    "sub_accounts": "<array>",
    "updated_at": "<string>"
  },
  "error": true,
  "message": "<string>"
}

Authorizations

X-API-KEY · string · header · required

Body

application/json

Create account request

currencies · string[] · required

Supported currency symbols on this account.

Example:

["USDC", "ETH"]

reference · string · required

Bundling key: one chain_id per account per reference.

Example:

"treasury"

type · enum<string> · required

Account type. Create currently accepts CryptoPayIn only.

Available options: CryptoPayIn

Example:

"CryptoPayIn"

address · string

Self-custody wallet address (required when ManagedAccount is false).

chain_id · integer

Chain ID for the wallet/account.

Example:

8453

name · string

Human-readable account name.

Example:

"Treasury"

parent_account_id · string

Optional parent settlement account ID.

Example:

"42"

Response

200

application/json

OK

data · object

Response payload when the request succeeded.

Show child attributes

error · boolean

True when the request failed.

message · string

Human-readable status or error message.