Line Items

In HubSpot, line items can be thought of as a subset of products. When a product is attached to a deal, it becomes a line item. You can create line items that are unique to an individual quote, but they will not be added to your product library. The line items endpoints allow you to manage this data and sync it between HubSpot and other systems.

Line items, along with companies, contacts, deals, tickets, products, and quotes, are objects in the HubSpot CRM. Learn more about object properties, associations, relationships, and more in our Understanding the CRM guide. For a more detailed look at HubSpot record types, you can use our Guide to Records.

Example use case: Your company wants to better manage inventory. To do this, you can use the line items endpoints to see how often sales reps are adding specific products to deals. This information will help inform your inventory management model.

Line item properties

Line item details are stored in default and custom properties. Custom properties store specialized information and can be managed through the CRM object properties endpoints.

Checking for updates (recommended)

To allow for new functionality, HubSpot will occasionally update existing default properties, and users may also change their custom properties from time to time. If your integration works with line items, it's recommended that you use the object properties endpoints to periodically check for updates.

Associations between line items and other objects

Line items can only be associated with deals, and these associations are managed through the CRM associations endpoints. 

For visual representation of how objects relate to one another in HubSpot, check out the Object Relationships section on the "Understanding the CRM" page.

Please note: the line items Term property (hs_recurring_billing_period) accepts ISO-8601 period formats of PnYnMnD and PnW.

Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.