Skip to main content
PATCH
Update a Xero account

Path Parameters

code
string
required

The account code as it appears in the chart (URL-encoded when it carries reserved characters). For QuickBooks this is the account Id.

Required string length: 1 - 64
Example:

"1200"

Query Parameters

orgId
string
required

Organization ID. Use GET /v1/companies to discover available org/company pairs.

Example:

"1"

companyId
string
required

Company ID. Use GET /v1/companies to discover available companies and their access levels.

Example:

"1"

Body

application/json
name
string

New display name (max 150 chars).

Required string length: 1 - 150
type
enum<string>

New Xero account type. Xero refuses a type change on bank accounts and on system accounts; its message comes back as a 400.

Available options:
BANK,
CURRENT,
CURRLIAB,
DEPRECIATN,
DIRECTCOSTS,
EQUITY,
EXPENSE,
FIXED,
INVENTORY,
LIABILITY,
NONCURRENT,
OTHERINCOME,
OVERHEADS,
PREPAYMENT,
REVENUE,
SALES,
TERMLIAB,
PAYG
description
string

New description (not valid for BANK accounts).

Maximum string length: 4000
taxType
string

New default Xero tax type code.

enablePaymentsToAccount
boolean

Whether payments can be applied to the account (required on the AP Clearing account used by invoice payments).

showInExpenseClaims
boolean

Whether the account is offered on expense claims.

status
enum<string>

ARCHIVED archives the account at Xero and removes it from the stored chart; ACTIVE restores an archived account.

Available options:
ACTIVE,
ARCHIVED

Response

Xero account updated

success
enum<boolean>
required
Available options:
true
data
object
required
Last modified on November 13, 2026