In HubSpot, the companies object is a CRM object. You can use individual company records to store information about businesses and organizations within company properties. The companies endpoints allow you to manage this data and sync it between HubSpot and other systems. 

For example, your organization might use an external payment system with HubSpot as your CRM. When a company is delinquent on payments, you may want to make sure their company record is updated in HubSpot to reflect their payment status. To automatically sync this data, you'd use the companies API endpoints to integrate the two systems. These updates can then be used to pause marketing communications or notify a sales owner in HubSpot. 

The Understanding the CRM guide provides more information about object properties, associations, relationships. Learn more about working with records in HubSpot.


When managing companies through the API, the company ID is the unique identifier used for deduplication. Learn about record deduplication in HubSpot.

Company properties

Company details are stored in default and custom properties. These properties can be managed in your HubSpot account or through the CRM object properties endpoints. If a company has multiple domains, you can add them through the API by using the hs_additional_domains field with semicolons separating each domain. For example:

"hs_additional_domains" : ";;"

Learn more about using multiple domains with companies.

Lifecycle stage

To change a company's lifecycle stage via the API, set the value of lifecyclestage to the lifecycle stage's internal name. The internal IDs will also be returned when you retrieve the lifecycle stage property via API.

The internal names of default stages are text values, and do not change even if you edit the stage's label (e.g., subscriber or marketingqualifiedlead). The internal names of custom stages are numeric values. You can find a stage's internal ID in your lifecycle stage settings.

Checking for updates

To allow for new functionality, HubSpot will occasionally update existing default properties, and users may also add or update custom properties over time. If your integration works with companies, it's recommended that you use the properties endpoints periodically to check for updates.

Associations between companies and other records

Companies can be associated with contacts, deals, engagements, tickets, and custom object records, and they can also have parent-child company associations. You can manage associations using the CRM associations endpoints.

Companies have a one-to-many relationship with contacts, deals, tickets, and custom objects, which means that multiple contacts, tickets, deals, and custom object records can be associated with a single company. You can also associate multiple companies with a single record, and you can set one company as the primary associated company.

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