QuBe Sync: QuickBooks Desktop API for developers
com.qubesync/quickbooks-desktop-api · v1.0.0 · MCP 2025-06-18
Build QuickBooks Desktop integrations: validated API requests and workflows, answers by webhook.
Reachability
reachable
checked 2026-11-21 05:33 UTC
Registry status active
Tools pinned 100
cb2ba7aeb938
Tools last changed
unchanged since first capture 2026-11-19
Provenance
Registry namespace com.qubesync
(domain verified by the official registry)
Remote endpoints
https://qubesync.com/mcp (streamable-http)
Observed changes
| When (UTC) | Event | Detail |
|---|---|---|
| 2026-11-19 05:30 | first capture | 100 tools pinned |
Pinned tool definitions (100)
| Tool | Description |
|---|---|
| get_workflow_authoring_guide | Returns the QuBeSync workflow authoring guide: the rules for writing a workflow chart (a JSON statechart that runs qbXML requests against QuickBooks Desktop), the chart JSON Schema, and a canonical example. Load this before writing or... |
| validate_workflow_chart | Validates a workflow chart without saving or running it -- the same structural validation and lint as POST /api/v2/workflows/validate, minus the checks that need a specific app. Returns {valid, errors, warnings, workflows_to_create}.... |
| list_workflow_templates | Lists the workflow chart templates QuBeSync ships (key, name, description): complete, tested charts for the common multi-step jobs. These match names -- ranked against the connection's name index (ACME, Inc. finds Acme Inc) -- and ask... |
| get_workflow_template | Returns one shipped workflow chart template by key (see list_workflow_templates), with the child workflows it calls, every question it can ask (each `prompt.id`, with its options) and every way it can end, and the API calls that install... |
| report_confusion | Send feedback to the QuBe Sync team about something in this server, its guides, or the v2 API that confused you, so we can fix it. Use it when a tool description or guide was unclear or contradicted what actually happened, an error... |
| match_records | Finds the record in a customer's QuickBooks company file that a name means, even written differently -- QuickBooks itself only matches a name exactly, or by 'contains' on one list. Checks the arguments and returns the v2 request to send... |
| get_integration_checklist | Returns QuBe Sync's integration checklist as Markdown: the 53 rules an app integrating with QuBe Sync has to get right (verifying webhook signatures on the raw body, answering 2xx within 5 seconds and working in a job, a new run... |
| create_account | This message allows you to perform the same activities as a user does in the QB New Account form, which can be accessed in QB by selecting Lists->Chart of Accounts->Accounts->New. If you want the account to be a subaccount to an... |
| create_alert | Builds a v2 alert.create request. The `alert_add` wrapper from qbXML is also accepted. Returns the v2 request to send, and the webhook payload QuickBooks' answer arrives in (this operation's response_json: its data shape and the status... |
| create_ar_refund_credit_card | Adds a credit card refund transaction that is linked to one or more QuickBooks credit memo transactions. You can link the credit card refund to one or more of those credit transactions. The `ar_refund_credit_card_add` wrapper from... |
| create_bill | Adds a bill: money the business owes a vendor, entered in accounts payable. `vendor_ref` is required. Expenses go in `expense_line_add` and items received in `item_line_add`. To bill a whole open purchase order, link it with... |
| create_bill_payment_check | A BillPaymentCheckAdd request must include either `payment_amount`, `set_credit`, or `discount_amount` (or more than one of these). If none of these three is included, the SDK will return an error. The `bill_payment_check_add` wrapper... |
| create_bill_payment_credit_card | A BillPaymentCreditCardAdd request must include either `payment_amount`, `set_credit`, or `discount_amount` (or more than one of these). If none of these three is included, the SDK will return an error. The... |
| create_billing_rate | Adds a billing rate to the billing rate level list. After a billing rate is created, it can be assigned to an employee or vendor (VendorAdd/Mod, EmployeeAdd/Mod) via the BillingRateRef element in the appropriate request. Then, once the... |
| create_build_assembly | Adds a build assembly transaction to QuickBooks, where the specified quantity of the specified inventory assembly item is built. If there are insufficient quantities of items required for the build, you can have the build marked as a... |
| create_charge | Adds a customer charge. A Charge contains information about a statement charge. (A CreditCardCharge object, on the other hand, refers to a credit card charge incurred by the QuickBooks user.) The `charge_add` wrapper from qbXML is also... |
| create_check | The amount of a check is the total of the amounts assigned to expense lines and item lines. You can write a check for: The `check_add` wrapper from qbXML is also accepted. Returns the v2 request to send, and the webhook payload... |
| create_class | Classes can be used to separate transactions into meaningful categories. (For example, transactions could be classified according to department, business location, or type of work.) In QuickBooks, class tracking is off by default. The... |
| create_credit_card_charge | A credit card charge is a general charge incurred when a QuickBooks user makes a purchase using a credit card. Credit card charges for purchases can be tracked as expenses (in expense accounts) or as items. The `credit_card_charge_add`... |
| create_credit_card_credit | If a QuickBooks user returns merchandise and receives credit, the credit is entered in QuickBooks and assigned to the appropriate expense account. Typically, the assigned expense account reflects the same account, customer, and class... |
| create_credit_memo | Adds a credit memo: an amount the business owes a customer, for returned goods, an overpayment or a prepayment. It lowers the customer's balance, but isn't set against an invoice until a payment or the invoice applies it. `customer_ref`... |
| create_currency | Creates a user defined currency with the specified name and currency code, both of which will show up in the QuickBooks UI. The `currency_add` wrapper from qbXML is also accepted. Returns the v2 request to send, and the webhook payload... |
| create_customer | Adds a customer, or a job under one: set `parent_ref` to the customer and the job's `full_name` becomes `Parent:Job`. `name` is required. QuickBooks keeps customers, vendors, employees and other names in one name space, so a name any of... |
| create_customer_msg | Builds a v2 customer_msg.create request. The `customer_msg_add` wrapper from qbXML is also accepted. Returns the v2 request to send, and the webhook payload QuickBooks' answer arrives in (this operation's response_json: its data shape... |
| create_customer_type | Builds a v2 customer_type.create request. The `customer_type_add` wrapper from qbXML is also accepted. Returns the v2 request to send, and the webhook payload QuickBooks' answer arrives in (this operation's response_json: its data... |
| create_data_ext | Writes data to one data extension. This request can only be invoked if a data extension definition has already been defined for the target object type. That is, before you can perform the DataExtAdd on a particular customer, say John... |
| create_data_ext_def | This request adds a data extension definition to the specified object type (e.g. Customer) so that extension data can be written to a particular object of that type (e.g., this customer, John Smith. A data extension definition must be... |
| create_date_driven_terms | Date-driven terms show the day of the month by which payment is due and can include a discount for early payment. For example, the following date-driven term means that payment is due on the 30th of the month, with a 1% discount if... |
| create_deposit | After you receive payments from customers (see ReceivePayment), you can use the DepositAdd request to either deposit each payment directly into a QuickBooks bank account or you can group payments together. You can also choose the method... |
| create_employee | Adds an employee with personal data about the employee as well as certain payroll-related data. The `employee_add` wrapper from qbXML is also accepted. Returns the v2 request to send, and the webhook payload QuickBooks' answer arrives... |
| create_estimate | Adds an estimate: a quote or bid for a sale proposed to a customer. An estimate doesn't post to any account. `customer_ref` is required, and lines go in `estimate_line_add`. QuickBooks users can turn an accepted estimate into an... |
| create_inventory_adjustment | If the following conditions aren’t met, you will receive an error if you try to add an inventory adjustment through the SDK: The `inventory_adjustment_add` wrapper from qbXML is also accepted. Returns the v2 request to send, and the... |
| create_inventory_site | Builds a v2 inventory_site.create request. The `inventory_site_add` wrapper from qbXML is also accepted. Returns the v2 request to send, and the webhook payload QuickBooks' answer arrives in (this operation's response_json: its data... |
| create_invoice | Adds an invoice: what a customer owes for a sale they didn't pay in full when it was made (a sale paid in full is a sales receipt). `customer_ref` is required. Each line in `invoice_line_add` names an `item_ref` and two of `quantity`,... |
| create_item_discount | Adds a discount item. A discount item is a percentage or a fixed amount that will be subtracted from a total or subtotal. Items should be subtotaled (using an ItemSubtotal item) before a discount item is applied to them, because a... |
| create_item_fixed_asset | Adds a fixed-asset item. Fixed-asset items represent assets that will benefit a business for longer than one year. The purchase price of these fixed assets is typically expensed over a period of years, rather than in the year the... |
| create_item_group | Adds an item group. ItemGroup objects represent items that are grouped together for fast entry, and an ItemGroupRef aggregate refers to one of these item groups. In a request, if an ItemGroupRef aggregate includes both `full_name` and... |
| create_item_inventory | Adds an inventory item: merchandise the business buys, stocks and resells. `name` is required; give it the accounts it posts to, `income_account_ref`, `cogs_account_ref` and `asset_account_ref`. For stock already on hand that no... |
| create_item_inventory_assembly | Adds an inventory assembly item, which is an item that is assembled or manufactured from other inventory items. The items and/or assemblies that make up the assembly are called components. For Premier, an assembly can have a maximum of... |
| create_item_non_inventory | Adds a non-inventory item: something the business buys but doesn't stock, such as office supplies, or materials bought for one job and billed to the customer. Send `sales_or_purchase` for an item it only sells or only buys, or... |
| create_item_other_charge | Adds an other charge item: a charge that isn't a service or a product, such as delivery, setup fees or service charges. Send `sales_or_purchase` for a charge the business only sells or only buys, or `sales_and_purchase` for one it does... |
| create_item_payment | For an ItemPaymentAdd request, you can “set” the “Group with undeposited funds” radio button in QuickBooks either by not specifying `deposit_to_account_ref` at all, or by specifying the special UndepositedFunds account for the... |
| create_item_receipt | Adds an item receipt transaction, which is a transaction entered in QuickBooks when a shipment is received from a vendor. If you use PurchaseOrders to order from the vendor, you can link the item receipt to purchase order to receive the... |
| create_item_sales_tax | Adds a sales-tax item, which is an item used to calculate a single sales tax that is collected at a specified rate and paid to a single agency. (Compare with the ItemSalesTaxGroupAdd message.) An ItemSalesTaxRef aggregate refers to an... |
| create_item_sales_tax_group | Adds a sales-tax group item, which is an item used for calculating two or more sales taxes grouped together and applied to the same sale. For example, local and state taxes could be tracked separately but applied to a sale as one tax.... |
| create_item_service | Adds a service item: work the business sells or buys, such as labor, consulting hours or fees. Send `sales_or_purchase` for a service it only sells or only buys (one price, one account), or `sales_and_purchase` for one it does both with... |
| create_item_subtotal | Adds a subtotal item. On a sales form, a subtotal item will add up the amounts of the item lines above it, up to the previous subtotal. The `item_subtotal_add` wrapper from qbXML is also accepted. Returns the v2 request to send, and... |
| create_job_type | Adds a job type. A job type can be used to separate jobs into any categories that are meaningful to the business. A JobTypeRef aggregate refers to a job type on the JobType list. In a request, if a JobTypeRef aggregate includes both... |
| create_journal_entry | In versions 1.0 and 1.1, all debit lines in a JournalEntryAdd request had to appear first, followed by all credit lines. But in versions 2.0 and above, the debit and credit lines can be intermingled. A credit line can legally come first... |
| create_lead | Builds a v2 lead.create request. The `lead_add` wrapper from qbXML is also accepted. Returns the v2 request to send, and the webhook payload QuickBooks' answer arrives in (this operation's response_json: its data shape and the status... |
| create_list_display | A ListDisplayAdd request opens a form within the QuickBooks UI for adding a list element. Returns the v2 request to send, and the webhook payload QuickBooks' answer arrives in (this operation's response_json: its data shape and the... |
| create_other_name | Adds an other name. In QuickBooks, the “other names” list contains any names that don’t appear on customer, vendor, or employee lists. The `other_name_add` wrapper from qbXML is also accepted. Returns the v2 request to send, and the... |
| create_payment_method | Adds a payment method, which is the way a customer pays for goods or services, for example, cash, check, or Master Card. A PaymentMethodRef aggregate refers to an item on the PaymentMethod list. In a request, if a PaymentMethodRef... |
| create_payroll_item_addition | Builds a v2 payroll_item_addition.create request. The `payroll_item_addition_add` wrapper from qbXML is also accepted. Returns the v2 request to send, and the webhook payload QuickBooks' answer arrives in (this operation's... |
| create_payroll_item_company_contribution | Builds a v2 payroll_item_company_contribution.create request. The `payroll_item_company_contribution_add` wrapper from qbXML is also accepted. Returns the v2 request to send, and the webhook payload QuickBooks' answer arrives in (this... |
| create_payroll_item_deduction | Builds a v2 payroll_item_deduction.create request. The `payroll_item_deduction_add` wrapper from qbXML is also accepted. Returns the v2 request to send, and the webhook payload QuickBooks' answer arrives in (this operation's... |
| create_payroll_item_direct_deposit | Builds a v2 payroll_item_direct_deposit.create request. The `payroll_item_direct_deposit_add` wrapper from qbXML is also accepted. Returns the v2 request to send, and the webhook payload QuickBooks' answer arrives in (this operation's... |
| create_payroll_item_tax | Builds a v2 payroll_item_tax.create request. The `payroll_item_tax_add` wrapper from qbXML is also accepted. Returns the v2 request to send, and the webhook payload QuickBooks' answer arrives in (this operation's response_json: its... |
| create_payroll_item_wage | Adds a payroll wage item. Each payroll wage item describes and names a payment scheme, for example, Regular Pay or Overtime Pay. A PayrollItemWageRef aggregate refers to one of these wage items. In a request, if a PayrollItemWageRef... |
| create_payroll_item_workers_compensation | Builds a v2 payroll_item_workers_compensation.create request. The `payroll_item_workers_compensation_add` wrapper from qbXML is also accepted. Returns the v2 request to send, and the webhook payload QuickBooks' answer arrives in (this... |
| create_payroll_liability_adjustment | Builds a v2 payroll_liability_adjustment.create request. The `payroll_liability_adjustment_add` wrapper from qbXML is also accepted. Returns the v2 request to send, and the webhook payload QuickBooks' answer arrives in (this... |
| create_payroll_prior_payment | Builds a v2 payroll_prior_payment.create request. The `payroll_prior_payment_add` wrapper from qbXML is also accepted. Returns the v2 request to send, and the webhook payload QuickBooks' answer arrives in (this operation's... |
| create_payroll_year_to_date_adjustment | Builds a v2 payroll_year_to_date_adjustment.create request. The `payroll_year_to_date_adjustment_add` wrapper from qbXML is also accepted. Returns the v2 request to send, and the webhook payload QuickBooks' answer arrives in (this... |
| create_price_level | Adds a price level. You can use price levels to specify custom pricing for specific customers. Once you create a price level for a customer, QuickBooks will automatically use the custom price in new invoices, sales receipts, sales... |
| create_purchase_order | Adds a purchase order, which is an order submitted to a vendor. You can use ItemReceiptAdd to receive items against a purchase order as items arrive from the vendor. A purchase order is a non-posting transaction, so it doesn’t affect a... |
| create_sales_order | Adds a sales order: goods a customer has ordered, often on back order, to be invoiced when they ship. A sales order doesn't post to any account. `customer_ref` is required, and lines go in `sales_order_line_add`. Sales orders need... |
| create_sales_receipt | Adds a sales receipt: a sale paid in full when it was made, by cash, check or card. If the customer pays later, add an invoice instead and record the payment when it arrives. The money goes to `deposit_to_account_ref`. `customer_ref` is... |
| create_sales_rep | Adds a sales rep. The sales representative must be on the Employee, Vendor, or Other Names list within QuickBooks. Sales representative’s names and initials appear on the Rep drop-down list on QuickBooks sales forms. A SalesRepRef... |
| create_sales_tax_code | Adds a sales tax code. Each item on a sales form is assigned a sales-tax code that indicates whether the item is taxable or non-taxable, and why. Two general codes, which can be modified but not deleted, appear on the sales-tax code... |
| create_sales_tax_payment_check | Builds a v2 sales_tax_payment_check.create request. The `sales_tax_payment_check_add` wrapper from qbXML is also accepted. Returns the v2 request to send, and the webhook payload QuickBooks' answer arrives in (this operation's... |
| create_ship_method | Adds a shipping method, for example, standard mail or overnight delivery. A ShipMethodRef aggregate refers to an item on the ShipMethod list. In a request, if a ShipMethodRef aggregate includes both FullName and `list_id`, FullName will... |
| create_special_account | Adds a special account of the specified type to QuickBooks. A special account is an account normally created automatically as needed within the QuickBooks UI, or in the SDK via the SpecialAccountAdd request. Notice that default names... |
| create_special_item | Adds special items to QuickBooks that can’t be added via the other Item\*Add requests. The `special_item_add` wrapper from qbXML is also accepted. Returns the v2 request to send, and the webhook payload QuickBooks' answer arrives in... |
| create_standard_terms | Adds a standard term. Standard terms show the number of days within which payment is due and can include a discount for early payment. For example, the following standard term means that payment is due in 30 days, with a 1% discount if... |
| create_time_tracking | This request adds a time tracking transaction to QuickBooks, mirroring the time-tracking feature available in the QuickBooks UI. The time tracking feature allows a QuickBooks user to base payroll or invoices on time worked. You can add... |
| create_to_do | A “to do”list is used in QuickBooks to keep track of tasks. Notice the Notes field: when you do a query on the ToDo list (ToDoQuery), you can use the supplied name filters to search these Notes and filter by them. The `to_do_add`... |
| create_transfer | Builds a v2 transfer.create request. The `transfer_add` wrapper from qbXML is also accepted. Returns the v2 request to send, and the webhook payload QuickBooks' answer arrives in (this operation's response_json: its data shape and the... |
| create_transfer_inventory | Builds a v2 transfer_inventory.create request. The `transfer_inventory_add` wrapper from qbXML is also accepted. Returns the v2 request to send, and the webhook payload QuickBooks' answer arrives in (this operation's response_json: its... |
| create_txn_display | A TxnDisplayAdd request opens a form within the QuickBooks UI for adding a transaction. You may optionally supply an entity reference to “prefill” certain forms. Returns the v2 request to send, and the webhook payload QuickBooks'... |
| create_unit_of_measure_set | Requires the company to be enabled for unit of measure (UOM), either a single unit of measure per item, or multiple units of measure. However, in order to support both single or multiple units per item of measure enablement, you must... |
| create_vehicle | Adds a vehicle to the vehicle list for use in VehicleMileage transactions. Each vehicle name must be unique. The `vehicle_add` wrapper from qbXML is also accepted. Returns the v2 request to send, and the webhook payload QuickBooks'... |
| create_vehicle_mileage | Adds a VehicleMileage transaction involving the specified vehicle for the specified total miles or optionally for the QuickBooks calculated total miles if you supply the odometer start and end. The `vehicle_mileage_add` wrapper from... |
| create_vendor | Adds a vendor: a person or company the business buys from, including its banks and tax agencies. `name` is required. QuickBooks keeps vendors, customers, employees and other names in one name space, so a name any of them already uses... |
| create_vendor_credit | Adds a vendor credit. A vendor credit is also known as a “bill credit”. That is, it is a credit that a vendor owes you because you overpaid your bill, returned merchandise, or for some other reason. The VendorCredit is referenced in a... |
| create_vendor_type | Adds a vendor type. A vendor type allows business owners to categorize vendors in ways that are meaningful for their businesses. For example, a vendor type might indicate which industry a vendor represents, or which part of the country... |
| create_workers_comp_code | Adds a workers’ compensation code with one or more rate entries (each rate entry has an effective date and a rate). You can assign effective dates in the past, present or future. However, only one future date will be used. If a future... |
| delete_alert | Builds a v2 alert.delete request. Returns the v2 request to send, and the webhook payload QuickBooks' answer arrives in (this operation's response_json: its data shape and the status codes to handle). Possible errors (error.code /... |
| delete_data_event_recovery_info | Deletes the data event recovery information for the given subscriber. An application would send a DataEventRecoveryInfoDel request after having recovered its data events. For details about the event-notification feature, see the chapter... |
| delete_data_ext | This request deletes the data from the specified existing custom field or private extension. If you want to clear the data extension value (to make the custom field or private extension blank), you must use `data_ext_del`. The... |
| delete_data_ext_def | Deletes the private data extension definition specified by `owner_id` and `data_ext_name`. This delete will be successful only for private data extensions. Returns the v2 request to send, and the webhook payload QuickBooks' answer... |
| delete_list | You can only delete a list item from a QuickBooks company file if the file is open in single-user mode. If the file is open in multiuser mode, your application will receive an error. (This restriction doesn’t apply to deleting or... |
| delete_txn | Deleting a transaction removes it completely and irreversibly. (Using a TxnVoid request to void a transaction, on the other hand, sets its amount to zero but keeps a record of it in QuickBooks.) Returns the v2 request to send, and the... |
| execute_list_merge | This request merges one list object into another list object of the same type. Currently you can merge customers/jobs, or vendors, or accounts. The consequence of the merge is that only the merge-to object remains. The merge-from object... |
| execute_qb_command_exec | Builds a v2 qb_command_exec.execute request. Returns the v2 request to send, and the webhook payload QuickBooks' answer arrives in (this operation's response_json: its data shape and the status codes to handle). Possible errors... |
| execute_txn_void | Voids a transaction: QuickBooks keeps it, with its amounts and its lines' quantities at zero and "VOID: " in front of its memo, while deleting one removes it completely. A voided invoice keeps its number and reads back as paid. An... |
| find_account_tax_line_infos | Used to determine which tax line values are available for the `tax_line_id` value for AccountMod and AccountAdd requests that use the `tax_line_id` field to map the account to a federal tax line. Returns the v2 request to send, and the... |
| find_accounts | Finds accounts in the chart of accounts, all of them or those of one `account_type`, each with its parent account. It returns an account's own details, not its transactions. When the company shows account numbers, a `full_name` made of... |
| find_aging_reports | An aging report tracks outstanding invoices (in accounts receivable accounts) and unpaid bills (in accounts payable accounts). Notice that you could use a collections report instead of the aging query, if that better suited your... |
| find_alerts | Builds a v2 alert.query request. Returns the v2 request to send, and the webhook payload QuickBooks' answer arrives in (this operation's response_json: its data shape and the status codes to handle). Possible errors (error.code /... |
| find_ar_refund_credit_cards | Retrieves the specified credit card refund transaction or transactions. Returns the v2 request to send, and the webhook payload QuickBooks' answer arrives in (this operation's response_json: its data shape and the status codes to... |
Get alerted when this changes.
Email the moment com.qubesync/quickbooks-desktop-api drifts, dies, or revives.
Status badge
[](https://toolpin.dev/servers/com.qubesync/quickbooks-desktop-api)
Maintain this server? Add the badge to your README. It links your users to this live status page.