---
title: "Create an account"
method: POST
path: "/plans/{plan_id}/accounts"
tags: ["Accounts"]
---

# Create an account

`POST /plans/{plan_id}/accounts`

Creates a new account

## Path parameters

- `plan_id` string, required

## Request body

- PostAccountWrapper
  - `account` SaveAccount, required
    - `name` string, required — The name of the account
    - `type` 'checking' | 'savings' | 'cash' | 'creditCard' | 'otherAsset' | 'otherLiability', required — The type of account to create or update
    - `balance` integer, required — The current balance of the account in milliunits format

## Response `201`

The account was successfully created

- AccountResponse
  - `data` object, required
    - `account` Account, required
      - `id` string, uuid, required
      - `name` string, required
      - `type` 'checking' | 'savings' | 'cash' | 'creditCard' | 'lineOfCredit' | 'otherAsset' | 'otherLiability' | 'mortgage' | 'autoLoan' | 'studentLoan' | 'personalLoan' | 'medicalDebt' | 'otherDebt', required — The type of account
      - `on_budget` boolean, required — Whether this account is "on budget" or not
      - `closed` boolean, required — Whether this account is closed or not
      - `note` string, nullable
      - `balance` integer, required — The current available balance of the account in milliunits format
      - `cleared_balance` integer, required — The current cleared balance of the account in milliunits format
      - `uncleared_balance` integer, required — The current uncleared balance of the account in milliunits format
      - `transfer_payee_id` string, uuid, nullable, required — The payee id which should be used when transferring to this account
      - `direct_import_linked` boolean — Whether or not the account is linked to a financial institution for automatic transaction import.
      - `direct_import_in_error` boolean — If an account linked to a financial institution (direct_import_linked=true) and the linked connection is not in a healthy state, this will be true.
      - `last_reconciled_at` string, date-time, nullable — A date/time specifying when the account was last reconciled.
      - `debt_original_balance` integer, nullable — This field is deprecated and will always be null.
      - `debt_interest_rates` LoanAccountPeriodicValue, nullable
      - `debt_minimum_payments` LoanAccountPeriodicValue, nullable
      - `debt_escrow_amounts` LoanAccountPeriodicValue, nullable
      - `deleted` boolean, required — Whether or not the account has been deleted. Deleted accounts will only be included in delta requests.
      - `balance_formatted` string — The current available balance of the account formatted in the plan's currency format
      - `balance_currency` number, double — The current available balance of the account as a decimal currency amount
      - `cleared_balance_formatted` string — The current cleared balance of the account formatted in the plan's currency format
      - `cleared_balance_currency` number, double — The current cleared balance of the account as a decimal currency amount
      - `uncleared_balance_formatted` string — The current uncleared balance of the account formatted in the plan's currency format
      - `uncleared_balance_currency` number, double — The current uncleared balance of the account as a decimal currency amount

## Other responses

- `400` — The request could not be understood due to malformed syntax or validation error(s).

---

[API](https://skmtc.dev/ynab/apis/ynab-api-endpoints.md) · [All operations](https://skmtc.dev/ynab/apis/ynab-api-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ynab/ynab-api-endpoints/revisions/da7a78345b34/schema)