---
title: "Creates a Account resource."
method: POST
path: "/accounts"
tags: ["Account"]
---

# Creates a Account resource.

`POST /accounts`

## Request

- Base URL: `https://example.myintranetapps.com/api`
- URL: `https://example.myintranetapps.com/api/accounts`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/bossinsights/apis/boss-insights/docs/accounts/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a Account resource.

## Request body

- Account: Accounting chart of accounts
  - `id` string: unique identifier for this account note that no particular pattern in this field is guaranteed, only that this field is unique e.g. "quickbooks-726"
  - `integration` string: The key of the integration source e.g. "quickbooks", or "xero"
  - `code` string, nullable: customer defined code for the account e.g. "400" e.g. "SALES"
  - `taxType` string, nullable: a tax code used for the account e.g. "TAX001"
  - `bankAccountNumber` string, nullable: a code used to identify a bank account, only applies to accounts directly linked to a bank account e.g. "823772-2828773-09826"
  - `bankAccountType` string, nullable: indicates the type of bank account being used e.g. "BANK" e.g. "CREDITCARD" e.g. "PAYPAL"
  - `currencyCode` string, nullable: the currency code e.g. "USD"
  - `fullyQualifiedName` string, nullable: full canonical name for the account e.g. Short term cash
  - `name` string, nullable, required: short name for the account e.g. "Sandra's Bank Account"
  - `classification` string, nullable: The accounting classification of the account, typically one of Asset, Liability, Equity, Revenue, or Expense.
  - `accountSubType` string, nullable: application based classification of the account e.g. "BANK"
  - `currentBalanceWithSubAccounts` string, nullable: represents the total value of the account including any sub accounts in cents
  - `created` string, date-time, nullable: when the account was created
  - `modified` string, date-time, nullable: when any user modifiable attributes of the object were last changed
  - `accountType` string, nullable: the type or class of the account e.g. "ASSET"
  - `currentBalance` string, nullable: the value of the account excluding any sub accounts in cents
  - `active` boolean, nullable: whether or not the account is active and should be included in calculations
  - `subAccount` boolean, nullable: whether this account is actually a subaccount of another account
  - `description` string, nullable: a user definable long form description of the account e.g. "This is the main company account for income and expenses"
  - `srcId` string, nullable: the unique identifier of the source 3rd party integration e.g. "GH2JK-67283H-YW82KHX-2883KK-KS78S"
  - `parentAccountId` string, nullable: if this is a subaccount then the id of the parent account e.g. "JS882-67283H-YW82KHX-2883KK-DJ3SK"
  - `deleted` boolean, nullable: whether or not the account is active

## Response `201`

Account resource created

- Account: Accounting chart of accounts
  - `id` string: unique identifier for this account note that no particular pattern in this field is guaranteed, only that this field is unique e.g. "quickbooks-726"
  - `integration` string: The key of the integration source e.g. "quickbooks", or "xero"
  - `code` string, nullable: customer defined code for the account e.g. "400" e.g. "SALES"
  - `taxType` string, nullable: a tax code used for the account e.g. "TAX001"
  - `bankAccountNumber` string, nullable: a code used to identify a bank account, only applies to accounts directly linked to a bank account e.g. "823772-2828773-09826"
  - `bankAccountType` string, nullable: indicates the type of bank account being used e.g. "BANK" e.g. "CREDITCARD" e.g. "PAYPAL"
  - `currencyCode` string, nullable: the currency code e.g. "USD"
  - `fullyQualifiedName` string, nullable: full canonical name for the account e.g. Short term cash
  - `name` string, nullable, required: short name for the account e.g. "Sandra's Bank Account"
  - `classification` string, nullable: The accounting classification of the account, typically one of Asset, Liability, Equity, Revenue, or Expense.
  - `accountSubType` string, nullable: application based classification of the account e.g. "BANK"
  - `currentBalanceWithSubAccounts` string, nullable: represents the total value of the account including any sub accounts in cents
  - `created` string, date-time, nullable: when the account was created
  - `modified` string, date-time, nullable: when any user modifiable attributes of the object were last changed
  - `accountType` string, nullable: the type or class of the account e.g. "ASSET"
  - `currentBalance` string, nullable: the value of the account excluding any sub accounts in cents
  - `active` boolean, nullable: whether or not the account is active and should be included in calculations
  - `subAccount` boolean, nullable: whether this account is actually a subaccount of another account
  - `description` string, nullable: a user definable long form description of the account e.g. "This is the main company account for income and expenses"
  - `srcId` string, nullable: the unique identifier of the source 3rd party integration e.g. "GH2JK-67283H-YW82KHX-2883KK-KS78S"
  - `parentAccountId` string, nullable: if this is a subaccount then the id of the parent account e.g. "JS882-67283H-YW82KHX-2883KK-DJ3SK"
  - `deleted` boolean, nullable: whether or not the account is active

## Other responses

- `400`: Invalid input
- `422`: Unprocessable entity

---

[API](https://skmtc.dev/bossinsights/apis/boss-insights.md) - [All operations](https://skmtc.dev/bossinsights/apis/boss-insights/llms.txt) - [OpenAPI document](https://skmtc.dev/bossinsights/apis/boss-insights/revisions/d08a107895ad?raw)