The API is built to allow you to create a functional application or integration quickly and easily. We know from experience - these are the APIs that power the HubSpot application. The ecosystem of developers creating integrations on top of the APIs is strong and diverse, ranging from webinar providers to CRMs to social media.
All of the HubSpot APIs are organized around REST - if you've interacted with a RESTful API already, many of the concepts will be familiar to you. All API calls to HubSpot should be made to the https://api.hubapi.com base domain. We use many standard HTTP features, like HTTP verbs, which can be understood by many HTTP clients. JSON will be returned in all responses from the API, including errors. The APIs are designed to have predictable, straightforward URLs and to use HTTP response codes to indicate API errors.
If you're considering an integration with HubSpot for commercial use - i.e. installation by mutual customers - you can learn more how to get certified and featured by HubSpot here.
HubSpot's APIs are subject to rate limiting. These limits are applied per account for custom integrations using API keys or per app per account for integrations using OAuth. You can see the specific limits detailed in our full API guidelines.
Each HubSpot account will have access to different APIs based on the products and product levels it has. You can see a detailed breakdown for which APIs are supported for each product level on our APIs by Product Tier page.
The HubSpot APIs allow for two types of authentication, OAuth and API keys. See our Authentication Overview for more details about authenticating requests.
API keys are great for rapid prototyping, but for security and commercial use, all integrations should strive to use OAuth.
demo API key can only be used to make GET requests. Other requests methods will return an error. Please create a test account for any further testing.
Most documentation pages will have example URLs that can be used to quickly check the data returned by the endpoint, using public demo data. Once you're ready to start testing, you should create a test account. Test accounts have access to Enterprise versions of the HubSpot Marketing, Sales, and Service Hubs, allowing you to test most of the HubSpot APIs and tools.
In order to get started, the first thing you'll want to do is create a developer account. Your developer account will be your starting point for creating any test accounts, as well as letting you create an application to get started with OAuth.
If you've ever got questions, feel free to check out our developer forum or to leave us some feedback using the Submit Feedback button throughout the site.