CustomerAdd qbXML example
Adds a customer or, with a ParentRef, a job under one.
qbXML
CustomerAddRq, version 16.0
<?xml version="1.0" encoding="utf-8"?>
<?qbxml version="16.0"?>
<QBXML>
<QBXMLMsgsRq onError="stopOnError">
<CustomerAddRq>
<CustomerAdd>
<Name>Acme Corp</Name>
<CompanyName>Acme Corp</CompanyName>
<BillAddress>
<Addr1>123 Main St</Addr1>
<City>Springfield</City>
<State>IL</State>
<PostalCode>62701</PostalCode>
</BillAddress>
<Phone>555-0100</Phone>
<Email>billing@acme.example</Email>
</CustomerAdd>
</CustomerAddRq>
</QBXMLMsgsRq>
</QBXML>
Open in the validator
Check it against the qbXML 16.0 schema, edit it, and run it in your own QuickBooks.
Things to know
- Elements must appear in the order the schema lists them: a valid element in the wrong place fails validation.
- Write a character above ASCII (é, ©, a curly quote) as a numeric reference such as é. Written as itself, it fails the whole document.
- Name must be unique among customers, vendors, employees and other names.
The same request with QuBe Sync's API
QuBe Sync takes this JSON, writes the qbXML for you and delivers QuickBooks' answer to your webhook as JSON.
POST
/api/v2/connections/{connection_id}/customers
{
"bill_address": {
"addr1": "123 Main St",
"city": "Springfield",
"postal_code": "62701",
"state": "IL"
},
"company_name": "Acme Corp",
"email": "billing@acme.example",
"name": "Acme Corp",
"phone": "555-0100"
}
Every field CustomerAdd takes is in Intuit's reference.
More requests
Customers and sales