Create a Company

Last updated April 16, 2019

POST /companies/v2/companies/

Method Details

HTTP Methods:


Content Type:


Response Format:


Requires Authentication?


Rate Limited?





Marketing & CRM

Required Scope:


For a given account, create a company. This is particularly useful if you're integrating with a CRM or another application that has a similar notion of a company.

This will return an object representing your newly created company.

Required Parameters How to use Description
OAuth Access Token or API Key Authorization: Bearer {token} header
or hapikey={key} query parameter.
Used to authenticate the request. Please see this page for more details about authentication.
Company JSON Used in the request body This is JSON that represents a company that you're creating. This should be in the format of the code sample below.
Optional Parameters How to use Description
None None No optional parameters for this method.

If your request is successful, you'll receive a 200 with an object representing the company you have created.

Store the companyId, as it will be the company's unique identifier in HubSpot. You'll likely want to associate some contacts with the company after you've created it. For more information on how to do so, see our Companies API Overview.