LedgerWire

Customer · Mod

simulated in sandbox

CustomerMod

Customers are the people and companies you invoice. In QuickBooks Desktop they live in the Customer:Job list, share a name space with vendors and employees, and carry balances that QuickBooks maintains for you.

qbXML request

CustomerModRq
<?xml version="1.0" encoding="utf-8"?>
<?qbxml version="13.0"?>
<QBXML>
  <QBXMLMsgsRq onError="stopOnError">
    <CustomerModRq requestID="1">
      <CustomerMod>
        <ListID>80000055-1794881749</ListID>
        <EditSequence>1771772735</EditSequence>
        <Phone>(614) 555-0177</Phone>
        <Email>ap@bayside.example</Email>
      </CustomerMod>
    </CustomerModRq>
  </QBXMLMsgsRq>
</QBXML>

JSON equivalent

POST /v1/customers/80000055-1794881749
{
  "email": "ap@bayside.example",
  "phone": "(614) 555-0177",
  "editSequence": "1771772735"
}
curl
curl -X POST https://ledgerwire.vibiz.app/v1/customers/80000055-1794881749 \
  -H "Authorization: Bearer $LEDGERWIRE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"ap@bayside.example","phone":"(614) 555-0177","editSequence":"1771772735"}'

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)

CustomerModRs
<?xml version="1.0" ?>
<QBXML>
  <QBXMLMsgsRs>
    <CustomerModRs requestID="1" statusCode="0" statusSeverity="Info" statusMessage="Status OK">
      <CustomerRet>
        <ListID>80000055-1794881749</ListID>
        <TimeCreated>2026-02-22T15:05:35+00:00</TimeCreated>
        <TimeModified>2026-02-22T15:05:35+00:00</TimeModified>
        <EditSequence>1771772795</EditSequence>
        <Name>Lakeshore Mechanical Co</Name>
        <FullName>Lakeshore Mechanical Co</FullName>
        <IsActive>true</IsActive>
        <Sublevel>0</Sublevel>
        <CompanyName>Lakeshore Mechanical Co</CompanyName>
        <FirstName>Andre</FirstName>
        <LastName>Lopez</LastName>
        <BillAddress>
          <Addr1>Lakeshore Mechanical Co</Addr1>
          <Addr2>2944 Park Blvd</Addr2>
          <City>Omaha</City>
          <State>NE</State>
          <PostalCode>68102</PostalCode>
          <Country>US</Country>
        </BillAddress>
        <Phone>(614) 555-0177</Phone>
        <Email>ap@bayside.example</Email>
        <Contact>Andre Lopez</Contact>
        <TermsRef>
          <FullName>Due on receipt</FullName>
        </TermsRef>
        <JobStatus>None</JobStatus>
        <Balance>1951.00</Balance>
        <TotalBalance>1951.00</TotalBalance>
      </CustomerRet>
    </CustomerModRs>
  </QBXMLMsgsRs>
</QBXML>

FAQ

Why does CustomerMod need EditSequence?

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

Does CustomerMod 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 CustomerMod from JSON?

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

Sandbox fidelity

The LedgerWire sandbox simulates CustomerMod 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 Customer messages

Other Mod messages

Skip the XML: call POST /v1/customers/80000055-1794881749 with JSON.

Get a free sandbox key