In HubSpot, the companies object is a standard 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.
Learn more about object properties, associations, relationships, and more in the Understanding the CRM guide. For a more detailed look at HubSpot record types and how to use them, check out the records guide on HubSpot's Knowledge Base.
When managing companies through the API, the company ID is the unique identifier used for deduplication. Learn about record deduplication in HubSpot's Knowledge Base.
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" : "domain.com; domain2.com; domain3.com"
Learn more about using multiple domains with companies in HubSpot's Knowledge Base.
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, and deals can be associated with a single company, but only one company can be associated with a single contact, ticket, or deal. Any contacts or deals associated with a company will appear as related items on the company record in HubSpot.
For visual representation of how objects relate to one another in HubSpot, check out the Object Relationships section of the Understanding the CRM guide.
Thank you for your feedback, it means a lot to us.