LedgerWire

Account · Mod

simulated in sandbox

AccountMod

Accounts make up the chart of accounts: banks, AR and AP, income, cost of goods sold and expenses. Every transaction line ultimately points at one.

qbXML request

AccountModRq
<?xml version="1.0" encoding="utf-8"?>
<?qbxml version="13.0"?>
<QBXML>
  <QBXMLMsgsRq onError="stopOnError">
    <AccountModRq requestID="1">
      <AccountMod>
        <ListID>80000001-1760311862</ListID>
        <EditSequence>1760311862</EditSequence>
        <Desc>Tools, lifts and shop equipment</Desc>
      </AccountMod>
    </AccountModRq>
  </QBXMLMsgsRq>
</QBXML>

JSON equivalent

POST /v1/accounts/80000001-1760311862
{
  "desc": "Tools, lifts and shop equipment",
  "editSequence": "1760311862"
}
curl
curl -X POST https://ledgerwire.vibiz.app/v1/accounts/80000001-1760311862 \
  -H "Authorization: Bearer $LEDGERWIRE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"desc":"Tools, lifts and shop equipment","editSequence":"1760311862"}'

Run this request against your own sandbox

Add and Mod requests change data, so they run in a private sandbox, not the shared demo. Get a free key (10 seconds), then POST the request above to /v1/qbxml.

qbXML response (from the sandbox seed data)

AccountModRs
<?xml version="1.0" ?>
<QBXML>
  <QBXMLMsgsRs>
    <AccountModRs requestID="1" statusCode="0" statusSeverity="Info" statusMessage="Status OK">
      <AccountRet>
        <ListID>80000001-1760311862</ListID>
        <TimeCreated>2025-10-12T23:31:02+00:00</TimeCreated>
        <TimeModified>2025-10-12T23:31:02+00:00</TimeModified>
        <EditSequence>1760311922</EditSequence>
        <Name>Checking</Name>
        <FullName>Checking</FullName>
        <IsActive>true</IsActive>
        <Sublevel>0</Sublevel>
        <AccountType>Bank</AccountType>
        <AccountNumber>1000</AccountNumber>
        <Desc>Tools, lifts and shop equipment</Desc>
        <Balance>48210.37</Balance>
        <TotalBalance>48210.37</TotalBalance>
      </AccountRet>
    </AccountModRs>
  </QBXMLMsgsRs>
</QBXML>

FAQ

Why does AccountMod need EditSequence?

QuickBooks uses EditSequence for optimistic locking. Send the value from your last query; if someone changed the account since, QuickBooks answers 3200 and you re-read and retry.

Does AccountMod replace the whole record?

No, only the elements you send change. Lines are the exception on transactions: send every line you want to keep with its TxnLineID, and TxnLineID -1 for new ones.

How do I call AccountMod from JSON?

POST /v1/accounts/{id} with the editSequence and the fields to change. LedgerWire builds the AccountModRq for you.

Sandbox fidelity

The LedgerWire sandbox simulates AccountMod with QuickBooks rules: required fields, element names, refs that must exist (3140), unique names (3100), field lengths (3070) and EditSequence locking (3200). Tax calculation, custom fields and preferences are not simulated.

More Account messages

Other Mod messages

Skip the XML: call POST /v1/accounts/80000001-1760311862 with JSON.

Get a free sandbox key