---
title: "Create Subaccount"
method: POST
path: "/v1/subaccounts"
tags: ["subaccounts"]
---

# Create Subaccount

`POST /v1/subaccounts`

Create a new trading subaccount for the authenticated user.

## Request body

- SubaccountCreate — Schema for creating a new subaccount.
  - `name` string, required
  - `description` string, nullable
  - `account_type` 'custodial' | 'non_custodial' — Type of trading subaccount.

## Response `201`

Successful Response

- SubaccountResponse — Schema for subaccount response.
  - `subaccount_id` string, uuid, required
  - `name` string, required
  - `description` string, nullable
  - `account_type` 'custodial' | 'non_custodial', required — Type of trading subaccount.
  - `is_active` boolean, required
  - `inserted_at` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/rivermarkets/apis/river-finance-api.md) · [All operations](https://skmtc.net/rivermarkets/apis/river-finance-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rivermarkets/river-finance-api/versions/0f4eceac44fb/schema)