Create manual account

Create a manual (non-bank-linked) account — bank, credit_card, investment, or loan — and seed today's balance snapshot. `subtype` must belong to the chosen `type` vocabulary (see schema). `creditLimit` only valid when `type === "credit_card"`. `currentBalance` is signed: positive for assets, negative for liabilities.

Authorization

bearerAuth

AuthorizationBearer <token>

Cobalt API key (prefix ck_live_). Issue from dashboard → Settings → API keys.

In: header

Request Body

application/json

Account to create

TypeScript Definitions

Use the request body type in TypeScript.

creditLimit?number

Credit limit. Only valid when type === "credit_card".

currency?string

currentBalance*number

Signed balance. Positive for assets, negative for liabilities (credit_card, loan). Magnitude stored internally.

logoDomain?string

name*string

subtype*string

type*string

Response Body

`application/json`

curl -X POST "https://example.com/accounts" \  -H "Content-Type: application/json" \  -d '{    "currentBalance": 0,    "name": "string",    "subtype": "checking",    "type": "bank"  }'

{
  "balance": 0,
  "creditLimit": 0,
  "currency": "USD",
  "id": "string",
  "institution": "string",
  "mask": "string",
  "name": "string",
  "type": "bank"
}

{
  "code": "string",
  "error": "string"
}

{
  "error": {
    "issues": [
      {
        "code": "string",
        "message": "string",
        "path": [
          "string"
        ]
      }
    ],
    "name": "string"
  },
  "success": true
}

Create manual account

Authorization

Request Body

Response Body

201application/json

401application/json

422application/json

`application/json`

`application/json`

`application/json`