Create an account
Creates a new financial account. QuickBooks requires you to pick a supported account type for the chart of accounts, and non-posting types can’t be created through the API.
Headers
The ID of the End-User to receive this request.
The ID of the End-User to receive this request.
Request body
Example request
{
"name": "Accounts-Payable",
"isActive": true,
"parentId": "80000001-1234567890",
"accountType": "bank",
"accountNumber": "1010",
"bankAccountNumber": "123456789",
"description": "Accounts-payable are the amounts owed to suppliers for goods and services purchased on credit.",
"openingBalance": "1000.00",
"openingBalanceDate": "2023-01-01",
"salesTaxCodeId": "80000001-1234567890",
"taxLineId": 123,
"currencyId": "80000001-1234567890"
}Response
Returns the newly created account.
Example response
{
"id": "80000001-1234567890",
"objectType": "qbd_account",
"createdAt": "2025-01-01T12:34:56+00:00",
"updatedAt": "2025-02-01T12:34:56+00:00",
"revisionNumber": "1721172183",
"name": "Accounts-Payable",
"fullName": "Corporate:Accounts-Payable",
"isActive": true,
"parent": {
"id": "80000001-1234567890",
"fullName": "Corporate"
},
"sublevel": 1,
"accountType": "bank",
"specialAccountType": "undeposited_funds",
"isTaxAccount": true,
"accountNumber": "1010",
"bankAccountNumber": "123456789",
"description": "Accounts-payable are the amounts owed to suppliers for goods and services purchased on credit.",
"balance": "1000.00",
"totalBalance": "5000.00",
"salesTaxCode": {
"id": "80000001-1234567890",
"fullName": "Non"
},
"taxLineDetails": {
"taxLineId": 123,
"taxLineName": "State Sales Tax"
},
"cashFlowClassification": "operating",
"currency": {
"id": "80000001-1234567890",
"fullName": "USD"
},
"customFields": [
{
"ownerId": "0",
"name": "Customer Rating",
"type": "string_1024_type",
"value": "Premium"
}
]
}Changes
Changed in 4 of the 46 revisions of this API.503185
- ●
the
currencyIdrequest property's maxLength was set to36request-property-max-length-set
- ●
the
parentIdrequest property's maxLength was set to36request-property-max-length-set
- ●
the
salesTaxCodeIdrequest property's maxLength was set to36request-property-max-length-set
- ●
- ▲
response property
accountNumberlist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
balancelist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
bankAccountNumberlist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
cashFlowClassificationlist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
descriptionlist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
isTaxAccountlist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
specialAccountTypelist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
totalBalancelist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
the
currencyresponse's property type/format changed fromobjectnull/to/for status200response-property-type-changed
- ▲
the
parentresponse's property type/format changed fromobjectnull/to/for status200response-property-type-changed
- ▲
the
salesTaxCoderesponse's property type/format changed fromobjectnull/to/for status200response-property-type-changed
- ▲
removed the required property
currency/fullNamefrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
currency/idfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
parent/fullNamefrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
parent/idfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
salesTaxCode/fullNamefrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
salesTaxCode/idfrom the response with the200statusresponse-required-property-removed
- ○
added
qbd_tax_line_infosubschema #2to thetaxLineDetailsresponse propertyanyOflist for the response status200response-property-any-of-added
- ○
added
subschema #1subschema #2to thecurrencyresponse propertyanyOflist for the response status200response-property-any-of-added
- ○
added
subschema #1subschema #2to theparentresponse propertyanyOflist for the response status200response-property-any-of-added
- ○
added
subschema #1subschema #2to thesalesTaxCoderesponse propertyanyOflist for the response status200response-property-any-of-added
- ○
removed the
accounts_payableenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
accounts_receivableenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
condense_item_adjustment_expensesenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
cost_of_goods_soldenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
direct_deposit_liabilitiesenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
estimatesenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
exchange_gain_lossenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
financingenum value from thecashFlowClassificationresponse property for the response status200response-property-enum-value-removed
- ○
removed the
inventory_assetsenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
investingenum value from thecashFlowClassificationresponse property for the response status200response-property-enum-value-removed
- ○
removed the
item_receipt_accountenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
noneenum value from thecashFlowClassificationresponse property for the response status200response-property-enum-value-removed
- ○
removed the
not_applicableenum value from thecashFlowClassificationresponse property for the response status200response-property-enum-value-removed
- ○
removed the
opening_balance_equityenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
operatingenum value from thecashFlowClassificationresponse property for the response status200response-property-enum-value-removed
- ○
removed the
payroll_expensesenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
payroll_liabilitiesenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
petty_cashenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
purchase_ordersenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
reconciliation_differencesenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
retained_earningsenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
sales_ordersenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
sales_tax_payableenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
uncategorized_expensesenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
uncategorized_incomeenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
undefinedenum value from thecashFlowClassificationresponse property for the response status200response-property-enum-value-removed
- ○
removed the
undefinedenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
undeposited_fundsenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed
qbd_tax_line_infosubschema #2from thetaxLineDetailsresponse propertyoneOflist for the response status200response-property-one-of-removed
- ▲
- ▲
the response property
accountNumberbecame nullable for the status200response-property-became-nullable
- ▲
the response property
balancebecame nullable for the status200response-property-became-nullable
- ▲
the response property
bankAccountNumberbecame nullable for the status200response-property-became-nullable
- ▲
the response property
cashFlowClassificationbecame nullable for the status200response-property-became-nullable
- ▲
the response property
currencybecame nullable for the status200response-property-became-nullable
- ▲
the response property
descriptionbecame nullable for the status200response-property-became-nullable
- ▲
the response property
isTaxAccountbecame nullable for the status200response-property-became-nullable
- ▲
the response property
parentbecame nullable for the status200response-property-became-nullable
- ▲
the response property
salesTaxCodebecame nullable for the status200response-property-became-nullable
- ▲
the response property
specialAccountTypebecame nullable for the status200response-property-became-nullable
- ▲
the response property
totalBalancebecame nullable for the status200response-property-became-nullable
- ▲
added
qbd_tax_line_infosubschema #2to thetaxLineDetailsresponse propertyoneOflist for the response status200response-property-one-of-added
- ▲
the
currencyresponse's property type/format changed from/toobjectnull/for status200response-property-type-changed
- ▲
the
parentresponse's property type/format changed from/toobjectnull/for status200response-property-type-changed
- ▲
the
salesTaxCoderesponse's property type/format changed from/toobjectnull/for status200response-property-type-changed
- ●
added the new
accounts_payableenum value to thespecialAccountTyperesponse property for the response status200response-property-enum-value-added
- ●
added the new
accounts_receivableenum value to thespecialAccountTyperesponse property for the response status200response-property-enum-value-added
- ●
added the new
condense_item_adjustment_expensesenum value to thespecialAccountTyperesponse property for the response status200response-property-enum-value-added
- ●
added the new
cost_of_goods_soldenum value to thespecialAccountTyperesponse property for the response status200response-property-enum-value-added
- ●
added the new
direct_deposit_liabilitiesenum value to thespecialAccountTyperesponse property for the response status200response-property-enum-value-added
- ●
added the new
estimatesenum value to thespecialAccountTyperesponse property for the response status200response-property-enum-value-added
- ●
added the new
exchange_gain_lossenum value to thespecialAccountTyperesponse property for the response status200response-property-enum-value-added
- ●
added the new
financingenum value to thecashFlowClassificationresponse property for the response status200response-property-enum-value-added
- ●
added the new
inventory_assetsenum value to thespecialAccountTyperesponse property for the response status200response-property-enum-value-added
- ●
added the new
investingenum value to thecashFlowClassificationresponse property for the response status200response-property-enum-value-added
- ●
added the new
item_receipt_accountenum value to thespecialAccountTyperesponse property for the response status200response-property-enum-value-added
- ●
added the new
noneenum value to thecashFlowClassificationresponse property for the response status200response-property-enum-value-added
- ●
added the new
not_applicableenum value to thecashFlowClassificationresponse property for the response status200response-property-enum-value-added
- ●
added the new
opening_balance_equityenum value to thespecialAccountTyperesponse property for the response status200response-property-enum-value-added
- ●
added the new
operatingenum value to thecashFlowClassificationresponse property for the response status200response-property-enum-value-added
- ●
added the new
payroll_expensesenum value to thespecialAccountTyperesponse property for the response status200response-property-enum-value-added
- ●
added the new
payroll_liabilitiesenum value to thespecialAccountTyperesponse property for the response status200response-property-enum-value-added
- ●
added the new
petty_cashenum value to thespecialAccountTyperesponse property for the response status200response-property-enum-value-added
- ●
added the new
purchase_ordersenum value to thespecialAccountTyperesponse property for the response status200response-property-enum-value-added
- ●
added the new
reconciliation_differencesenum value to thespecialAccountTyperesponse property for the response status200response-property-enum-value-added
- ●
added the new
retained_earningsenum value to thespecialAccountTyperesponse property for the response status200response-property-enum-value-added
- ●
added the new
sales_ordersenum value to thespecialAccountTyperesponse property for the response status200response-property-enum-value-added
- ●
added the new
sales_tax_payableenum value to thespecialAccountTyperesponse property for the response status200response-property-enum-value-added
- ●
added the new
uncategorized_expensesenum value to thespecialAccountTyperesponse property for the response status200response-property-enum-value-added
- ●
added the new
uncategorized_incomeenum value to thespecialAccountTyperesponse property for the response status200response-property-enum-value-added
- ●
added the new
undefinedenum value to thecashFlowClassificationresponse property for the response status200response-property-enum-value-added
- ●
added the new
undefinedenum value to thespecialAccountTyperesponse property for the response status200response-property-enum-value-added
- ●
added the new
undeposited_fundsenum value to thespecialAccountTyperesponse property for the response status200response-property-enum-value-added
- ○
removed the pattern
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$from the request propertyopeningBalanceDaterequest-property-pattern-removed
- ○
removed
qbd_tax_line_infosubschema #2from thetaxLineDetailsresponse propertyanyOflist for the response status200response-property-any-of-removed
- ○
removed
subschema #1subschema #2from thecurrencyresponse propertyanyOflist for the response status200response-property-any-of-removed
- ○
removed
subschema #1subschema #2from theparentresponse propertyanyOflist for the response status200response-property-any-of-removed
- ○
removed
subschema #1subschema #2from thesalesTaxCoderesponse propertyanyOflist for the response status200response-property-any-of-removed
- ○
response property
accountNumberlist-of-types was narrowed by removing typesnullfrom media typeapplication/jsonof response200response-property-list-of-types-narrowed
- ○
response property
balancelist-of-types was narrowed by removing typesnullfrom media typeapplication/jsonof response200response-property-list-of-types-narrowed
- ○
response property
bankAccountNumberlist-of-types was narrowed by removing typesnullfrom media typeapplication/jsonof response200response-property-list-of-types-narrowed
- ○
response property
cashFlowClassificationlist-of-types was narrowed by removing typesnullfrom media typeapplication/jsonof response200response-property-list-of-types-narrowed
- ○
response property
descriptionlist-of-types was narrowed by removing typesnullfrom media typeapplication/jsonof response200response-property-list-of-types-narrowed
- ○
response property
isTaxAccountlist-of-types was narrowed by removing typesnullfrom media typeapplication/jsonof response200response-property-list-of-types-narrowed
- ○
response property
specialAccountTypelist-of-types was narrowed by removing typesnullfrom media typeapplication/jsonof response200response-property-list-of-types-narrowed
- ○
response property
totalBalancelist-of-types was narrowed by removing typesnullfrom media typeapplication/jsonof response200response-property-list-of-types-narrowed
- ○
added the required property
currency/fullNameto the response with the200statusresponse-required-property-added
- ○
added the required property
currency/idto the response with the200statusresponse-required-property-added
- ○
added the required property
parent/fullNameto the response with the200statusresponse-required-property-added
- ○
added the required property
parent/idto the response with the200statusresponse-required-property-added
- ○
added the required property
salesTaxCode/fullNameto the response with the200statusresponse-required-property-added
- ○
added the required property
salesTaxCode/idto the response with the200statusresponse-required-property-added
- ▲
- ▲
added the pattern
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$to the request propertyopeningBalanceDaterequest-property-pattern-added
- ▲
response property
accountNumberlist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
balancelist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
bankAccountNumberlist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
cashFlowClassificationlist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
descriptionlist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
isTaxAccountlist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
specialAccountTypelist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
totalBalancelist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
the
currencyresponse's property type/format changed fromobjectnull/to/for status200response-property-type-changed
- ▲
the
parentresponse's property type/format changed fromobjectnull/to/for status200response-property-type-changed
- ▲
the
salesTaxCoderesponse's property type/format changed fromobjectnull/to/for status200response-property-type-changed
- ▲
removed the required property
currency/fullNamefrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
currency/idfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
parent/fullNamefrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
parent/idfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
salesTaxCode/fullNamefrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
salesTaxCode/idfrom the response with the200statusresponse-required-property-removed
- ○
added
qbd_tax_line_infosubschema #2to thetaxLineDetailsresponse propertyanyOflist for the response status200response-property-any-of-added
- ○
added
subschema #1subschema #2to thecurrencyresponse propertyanyOflist for the response status200response-property-any-of-added
- ○
added
subschema #1subschema #2to theparentresponse propertyanyOflist for the response status200response-property-any-of-added
- ○
added
subschema #1subschema #2to thesalesTaxCoderesponse propertyanyOflist for the response status200response-property-any-of-added
- ○
removed the
accounts_payableenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
accounts_receivableenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
condense_item_adjustment_expensesenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
cost_of_goods_soldenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
direct_deposit_liabilitiesenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
estimatesenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
exchange_gain_lossenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
financingenum value from thecashFlowClassificationresponse property for the response status200response-property-enum-value-removed
- ○
removed the
inventory_assetsenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
investingenum value from thecashFlowClassificationresponse property for the response status200response-property-enum-value-removed
- ○
removed the
item_receipt_accountenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
noneenum value from thecashFlowClassificationresponse property for the response status200response-property-enum-value-removed
- ○
removed the
not_applicableenum value from thecashFlowClassificationresponse property for the response status200response-property-enum-value-removed
- ○
removed the
opening_balance_equityenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
operatingenum value from thecashFlowClassificationresponse property for the response status200response-property-enum-value-removed
- ○
removed the
payroll_expensesenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
payroll_liabilitiesenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
petty_cashenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
purchase_ordersenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
reconciliation_differencesenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
retained_earningsenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
sales_ordersenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
sales_tax_payableenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
uncategorized_expensesenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
uncategorized_incomeenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
undefinedenum value from thecashFlowClassificationresponse property for the response status200response-property-enum-value-removed
- ○
removed the
undefinedenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed the
undeposited_fundsenum value from thespecialAccountTyperesponse property for the response status200response-property-enum-value-removed
- ○
removed
qbd_tax_line_infosubschema #2from thetaxLineDetailsresponse propertyoneOflist for the response status200response-property-one-of-removed
- ▲