Welcome to the HubSpot API Documentation. HubSpot provides a variety of APIs for our customers, partners and development community. The documentation is complemented by our API Discussion Group which is free and open to the public.
If you are looking to create an app on HubSpot, there are a couple of options: internal apps, which are not public and internal to your organization and external apps, which are hosted by you, the developer but are listed and installable in the HubSpot App Marketplace.
To get started, have a look through the API methods in the pages listed below, or the marketplace docs if you're looking to create a public app for the HubSpot App Marketplace. You should also refer to our Authentication section for instructions on how to make API calls
Want to integrate with HubSpot? HubSpot's Marketing APIs let you interface much of HubSpot's marketing data via simple API calls.
Wondering what goes into building a HubSpot app? It's easier than you think! Marketing apps build on the HubSpot platform can be accessed via the HubSpot Marketplace, available in the HubSpot UI.
All our APIs are bound by the HubSpot Terms of Use. Please make sure you read and understand them before going further.
In addition to these Terms of Use, we ask that you be careful in your usage of our APIs so as not to flood our servers. Cache data on your end when possible, especially for time-consuming or expensive operations like querying across many leads.
To use our APIs, you need a valid OAuth Token. See our Authentication and OAuth pages for more. Our APIs are rate-limited to protect our servers from abuse, intentional or accidental.
There are two ways to get access to HubSpot as a developer:
