InHubSpot, companies store information about the organizations that interact with your business. The companies endpoints allow you to manage create and manage company records, as well as sync company data between HubSpot and other systems.
Learn more about objects, records, properties, and associations APIs in the Understanding the CRM guide. For more general information about objects and records in HubSpot, learn how to manage your CRM database.
In your request, include your company data in a properties object. You can also add an associations object to associate your new company with existing records (e.g., contacts, deals), or activities (e.g., meetings, notes).
When creating a new company, you should include at least one of the following properties in your request: name or domain. It is recommended to always include domain, because domain names are the primary unique identifier to avoid duplicate companies in HubSpot. 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".
When creating a new company, you can also associate the company with existing records or activities in an associations object. For example, to associate a new company with an existing contact and email, your request would look like the following:
The type of the association between the company and the record/activity. Include the associationCategoryand associationTypeId. Default association type IDs are listed here, or you can retrieve the value for custom association types (i.e. labels) via the associations API.
For the batch read endpoint, you can also use the optional idProperty parameter to retrieve companies by a custom unique identifier property. By default, the id values in the request refer to the record ID (hs_object_id), so the idProperty parameter is not required when retrieving by record ID. To use a custom unique value property to retrieve companies, you must include the idProperty parameter.
You can pin an activity on a company record via API by including the hs_pinned_engagement_id field in your request. In the field, include the id of the activity to pin, which can be retrieved via the engagements APIs. You can pin one activity per record, and the activity must already be associated with the company prior to pinning.
FinCEN has prepared the following Frequently Asked Questions (FAQs) in response to inquiries received relating to the Beneficial Ownership Information Reporting Rule and Beneficial Ownership Information Access and Safeguards Rule.
FinCEN published the rule that will govern access to and protection of beneficial ownership information on December 22, 2023. Beneficial ownership information reported to FinCEN will be stored in a secure, non-public database using rigorous information security methods and controls typically used in the Federal government to protect non-classified yet sensitive information systems at the highest security level. FinCEN will work closely with those authorized to access beneficial ownership information to ensure that they understand their roles and responsibilities in using the reported information only for authorized purposes and handling in a way that protects its security and confidentiality.
FinCEN is engaged in a robust outreach and education campaign to raise awareness of and help reporting companies understand the new reporting requirements. That campaign involves virtual and in-person outreach events and comprehensive guidance in a variety of formats and languages, including multimedia content and the Small Entity Compliance Guide, as well as new channels of communication, including social media platforms. FinCEN is also engaging with governmental offices at the federal and state levels, small business and trade associations, and interest groups.
FinCEN will continue to provide guidance, information, and updates related to the BOI reporting requirements on its BOI webpage,
www.fincen.gov/boi. Subscribe here to receive updates via email from FinCEN about BOI reporting obligations.
No. FinCEN expects that many, if not most, reporting companies will be able to submit their beneficial ownership information to FinCEN on their own using the guidance FinCEN has issued. Reporting companies that need help meeting their reporting obligations can consult with professional service providers such as lawyers or accountants.
Yes, 23 types of entities are exempt from the beneficial ownership information reporting requirements. These entities include publicly traded companies meeting specified requirements, many nonprofits, and certain large operating companies.
It depends. A domestic entity such as a statutory trust, business trust, or foundation is a reporting company only if it was created by the filing of a document with a secretary of state or similar office. Likewise, a foreign entity is a reporting company only if it filed a document with a secretary of state or a similar office to register to do business in the United States.
Entities should also consider if any exemptions to the reporting requirements apply to them. For example, a foundation may not be required to report beneficial ownership information to FinCEN if the foundation qualifies for the tax-exempt entity exemption.
No, unless a sole proprietorship was created (or, if a foreign sole proprietorship, registered to do business) in the United States by filing a document with a secretary of state or similar office. An entity is a reporting company only if it was created (or, if a foreign company, registered to do business) in the United States by filing such a document. Filing a document with a government agency to obtain (1) an IRS employer identification number, (2) a fictitious business name, or (3) a professional or occupational license does not create a new entity, and therefore does not make a sole proprietorship filing such a document a reporting company.
It depends. Homeowners associations (HOAs) can take different forms. As with any entity, if an HOA was not created by the filing of a document with a secretary of state or similar office, then it is not a domestic reporting company. An incorporated HOA or other HOA that was created by such a filing also may qualify for an exemption from the reporting requirements. For example, HOAs recognized by the IRS as section 501(c)(4) social welfare organizations (or that claim such status and meet the requirements) may qualify for the tax-exempt entity exemption. An incorporated HOA that is not a section 501(c)(4) organization, however, may fall within the reporting company definition and therefore be required to report BOI to FinCEN.
Yes, if the entity meets the reporting company definition and does not qualify for any exemptions to the reporting requirements. See Question C.1 for more information on what entities are reporting companies.
A company is not required to report its beneficial ownership information to FinCEN if it ceased to exist as a legal entity before January 1, 2024, meaning that it entirely completed the process of formally and irrevocably dissolving. A company that ceased to exist as a legal entity before the beneficial ownership information reporting requirements became effective January 1, 2024, was never subject to the reporting requirements and thus is not required to report its beneficial ownership information to FinCEN.
Although state or Tribal law may vary, a company typically completes the process of formally and irrevocably dissolving by, for example, filing dissolution paperwork with its jurisdiction of creation or registration, receiving written confirmation of dissolution, paying related taxes or fees, ceasing to conduct any business, and winding up its affairs (e.g., fully liquidating itself and closing all bank accounts).
If a reporting company (see Question C.1) continued to exist as a legal entity for any period of time on or after January 1, 2024 (i.e., did not entirely complete the process of formally and irrevocably dissolving before January 1, 2024), then it is required to report its beneficial ownership information to FinCEN, even if the company had wound up its affairs and ceased conducting business before January 1, 2024.
An individual can exercise substantial control over a reporting company in four different ways. If the individual falls into any of the categories below, the individual is exercising substantial control:
An ownership interest is generally an arrangement that establishes ownership rights in the reporting company. Examples of ownership interests include shares of equity, stock, voting rights, or any other mechanism used to establish ownership.
There are five instances in which an individual who would otherwise be a beneficial owner of a reporting company qualifies for an exception. In those cases, the reporting company does not have to report that individual as a beneficial owner to FinCEN.
The unaffiliated company itself cannot be a beneficial owner of the reporting company because a beneficial owner must be an individual. Any individuals that exercise substantial control over the reporting company through the unaffiliated company must be reported as beneficial owners of the reporting company. However, individuals who do not direct, determine, or have substantial influence over important decisions made by the reporting company, and do not otherwise exercise substantial control, may not be beneficial owners of the reporting company.
No. A beneficial owner of a company is any individual who, directly or indirectly, exercises substantial control over a reporting company, or who owns or controls at least 25 percent of the ownership interests of a reporting company.
If ownership of a reporting company is the subject of active litigation and an initial BOI report has not been filed, a person authorized by the company to file its beneficial ownership information should comply with the requirements by reporting:
3a8082e126