RIrillet
Chart of Accounts

Creates an account

Changed on

Adds an account to the chart of accounts for the organization. The account currency is inherited from the organization, its status is ACTIVE, and its default grouping and closing behavior are derived from the selected type and subtype.

post/accounts

Request

Request body

metadataInlineMetadataValues

Partial metadata update keyed by definition key. Omitting this property preserves all existing metadata. When supplied, omitted keys remain unchanged; null, empty, or whitespace-only values clear only the named key.

namestring required

Display name of the account.

codestring required

Unique account code within the organization. May contain letters, numbers, periods, and dashes.

type'ASSET' | 'LIABILITY' | 'EQUITY' | 'EXPENSE' | 'INCOME' required

Top-level accounting classification. Must be compatible with subtype. Allowed values: ASSET, LIABILITY, EQUITY, EXPENSE, INCOME.

subtype'Revenue' | 'Cost of Goods Sold' | 'Operating Expense' | 'Equity' | 'Equity, Compensation' | 'Other Current Liability' | 'Other Long Term Liability' | 'Accounts Payable' | 'Accounts Receivable' | 'Credit Card' | 'Fixed Assets' | 'Accumulated Depreciation' | 'Other Current Asset' | 'Bank' | 'Allowance for Doubtful Accounts' | 'Unbilled Revenue' | 'Deferred Revenue' | 'Prepaid Expense' | 'Deferred Commissions' | 'Right of Use Asset' | 'Other Assets' | 'Restricted Cash' | 'Accrued Expense' | 'Sales Tax Liability' | 'Debt' | 'Lease Liability' | 'Customer Deposits' | 'Customer Credit' | 'Additional Paid In Capital' | 'Accumulated Other Comprehensive Income' | 'Retained Earnings' | 'Operating Expense - Personnel' | 'Operating Expense - Office Expenses' | 'Operating Expense - Sales & Marketing' | 'Operating Expense - Commissions' | 'Operating Expense - Research & Development' | 'Non Operating Expense' | 'Non Operating Income' required

Accounting subtype. The following exact values are accepted and must be paired with the indicated type:

ASSET: Accounts Receivable, Fixed Assets, Accumulated Depreciation, Other Current Asset, Bank, Allowance for Doubtful Accounts, Unbilled Revenue, Prepaid Expense, Deferred Commissions, Right of Use Asset, Other Assets, Restricted Cash.

LIABILITY: Other Current Liability, Other Long Term Liability, Accounts Payable, Credit Card, Deferred Revenue, Accrued Expense, Sales Tax Liability, Debt, Lease Liability, Customer Deposits, Customer Credit.

EQUITY: Equity, Equity, Compensation, Additional Paid In Capital, Accumulated Other Comprehensive Income, Retained Earnings.

EXPENSE: Cost of Goods Sold, Operating Expense, Operating Expense - Personnel, Operating Expense - Office Expenses, Operating Expense - Sales & Marketing, Operating Expense - Commissions, Operating Expense - Research & Development, Non Operating Expense, Non Operating Income.

INCOME: Revenue.

intercompanyboolean required

Whether the account is used for intercompany accounting.

Example request

{
  "name": "My New Account",
  "code": "90909"
}

Response

OK

metadataobject nullable

Values keyed by metadata definition key, including stored values of archived definitions. Unset keys are omitted. Returns an empty object when no values exist.

idstring uuid required
codestring required

The account code found in the Chart of Accounts

namestring required
type'ASSET' | 'LIABILITY' | 'EQUITY' | 'EXPENSE' | 'INCOME' required
subtypestring required
status'ACTIVE' | 'INACTIVE' required
intercompanyboolean required
parent_groupingstring required

Name of the account group this account belongs to.

prepaid_account_codestring nullable

Code of the linked prepaid expense account. Applies to EXPENSE accounts; null for other account types.

updated_atstring date-time required

ISO 8601 timestamp in UTC timezone (must end with 'Z')

Example response

{
  "code": "11112",
  "name": "Mercury Savings",
  "subtype": "Bank"
}

Changes

  • c393d0102005Revision changes
    • info

      added the new optional request property

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status