Create custom fields

Custom fields allow you to create your own fields and sync them into QuickBooks Online. Using custom fields you can define custom business-specific fields, such as name, color, or size information, and fields for information that may be unique to your industry. The Custom Fields GraphQL API offers the ability to precisely define the data you want to fetch.

The support for the Custom Fields API depends on your specific QuickBooks Online product:

• Advanced and Intuit Enterprise Suite
• Plus
• Essentials

For QuickBooks Online Advanced and Intuit Enterprise Suite, you can create up to 12 custom fields for String, Integer, Date, and List data types in each of the following transactions types and add them to Customer, Vendor, or Projects:

• Sales/Invoice transactions: Sales Receipt, Invoice, Estimate, Credit memo, Refund Receipt
• Expense transactions: Purchase Order, Purchase (Cash, Check, and Credit Card), Bill, Credit Card Payment, Vendor Credit

You can also read, update, enable, and enable custom fields in a transaction.

With QuickBooks Online Plus you can create up to four custom fields for String, Integer, Date, and List data types for the following entities:

• Sales Transactions: Sales Receipt, Invoice, Estimate, Credit Memo, Refund Receipt
• Purchase Order

You can also read, update, enable, and enable custom fields in a transaction.

With QuickBooks Online Essentials, you can use the API to create up to three custom fields for String, Integer, Date, and List data types for the following Sales transactions:

• Sales Receipt
• Invoice
• Estimate
• Credit Memo
• Refund Receipt

You can use the API to read, update, and disable custom fields on a transaction.

To get started creating custom fields, go to Get started with the Custom Fields API.

We’ve provided some use cases to help you include custom fields in your app. See Use cases.

To see the Custom Fields API GraphQL reference, go to the GraphQL API Explorer.

For information on handling errors, see Fix GraphQL errors.

You can use the QuickBooks Online UI to create, read, update, enable, or disable custom field values on a transaction. For more on using the UI, see Manage custom fields (legacy).