QuickBooks: Create a category — response body — Item
Create a category: response body, field Item. Complete fields and constraints for contract 2026-10-20.
API reference · Contract 2026-10-20
SDK schema: Create a category — response body — Item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Additional keys: allowed |
Active | JSON | Optional | For categories, this is always set to true . |
Active (anyOf 1) | boolean | Alternative | |
Active (anyOf 2) | string | Alternative | Known values: true, false |
FullyQualifiedName | string | Optional | Colon-separated list of the top-level category, followed by each sub-category in the hierarchy. Takes the form of Category:SubCategory1:SubCategory2:… . Limited to 5 levels: 4 category levels with an inventory, non-inventory, or service item as the 5th. Read only: true |
Id | string | Optional | Unique identifier for this object. Read only: true |
Level | JSON | Optional | Specifies the level of the hierarchy in which the object is located. First sub-category level below the top-most category is 1. Returned in the response body only when SubItem is set to true . Sub-categories can be nested to a maximum depth of three levels below a top-level category. Read only: true |
Level (anyOf 1) | JSON | Alternative | |
Level (anyOf 1) (anyOf 1) | integer | Alternative | |
Level (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
Level (anyOf 2) | string | Alternative | |
MetaData | Model | Optional | Expand Read a bill — response body — Bill Meta Data Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications. |
Name | string | Optional | Name of the category. |
ParentRef | Model | Optional | Expand Read an item — response body — Item Class Ref Reference to the parent of this sub-category. Returned in the response body only when SubItem is set to true . Query the Item name list resource to determine the appropriate object for this reference. Use Item.Id and Item.DisplayName from that object for ParentRef.value and ParentRef.name , respectively. |
SubItem | JSON | Optional | Denotes this object is a sub-category. Returned in the response body if this object is a sub-category. true —This is a sub-category. false —This is a top-level category (default). |
SubItem (anyOf 1) | boolean | Alternative | |
SubItem (anyOf 2) | string | Alternative | Known values: true, false |
SyncToken | string | Optional | Version number of the object. It is used to lock an object for use by one app at a time. As soon as an application modifies an object, its SyncToken is incremented. Attempts to modify an object specifying an older SyncToken fails. Only the latest version of the object is maintained by QuickBooks Online. Read only: true |
Type | string | Optional | Set to the literal string, Category . When querying Item objects with minor versions earlier than 4 specified, Category types are returned as type Service . |
Referenced models: Read a bill — response body — Bill Meta Data, Read an item — response body — Item Class Ref