IQ Books — Accounts

Create an account

Creates a chart-of-accounts entry via the native account service. Requires scope iqbooks:write. Set role='vat_control' on a LIABILITY account to establish the organisation's VAT Control account, which is a prerequisite for any VAT-bearing posting (bank confirm, invoice issue, journal).

post/api/v1/iqbooks/organisations/{organisationId}/accounts

Request

  • Base URL: https://api.reconcileiq.com
  • URL: https://api.reconcileiq.com/api/v1/iqbooks/organisations/{organisationId}/accounts
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Path parameters

organisationIdinteger required

IQ Books organisation id. The caller must be an accepted member; otherwise 404 (no existence leak).

Request body

codestring required
namestring required
account_type'ASSET' | 'LIABILITY' | 'EQUITY' | 'REVENUE' | 'EXPENSE' | 'SUSPENSE' required
rolestring

Optional system role for this account. Set role='vat_control' to designate the organisation's VAT Control account. An organisation with no vat_control account cannot confirm VAT-bearing bank transactions, issue VAT invoices, or post VAT journals (those return 422 unprocessable_entity until one exists). Create one vat_control LIABILITY account per organisation before any VAT posting.

Response

Account created.

Changes

No recorded changes to this operation across all 1 revision of this API.