Skip to content
A client wrapper for the HubSpot API at
Branch: master
Clone or download
benwinding Remove duplicates in "hs/contactsLists" Methods (#83)
* Semi-colon broke build

* Remove correct contactLists.js
Latest commit 00880f1 Feb 3, 2020

Build Status (Release)

Hubspot Client API

A client wrapper for the HubSpot API at


npm install --save hubspot-api


Full documentation available at


const HubSpotClient = require('hubspot-api');
const hs = new HubSpotClient({ hapikey });
// or const hs = new HubSpotClient({ accessToken });
// or const hs = new HubSpotClient(); # for public methods, eg. Forms, HubDB

async function getContact(id){
  const contact = await hs.contacts.getById(827398123);
  return contact

// Or using traditional thenable Promises.
hs.contacts.getById(827398123).then(contact => {

Entities available

  • Blogs
  • Blog posts
  • Blog authors
  • Blog topics
  • Contacts
  • Contacts Properties (partial implementation)
  • Companies
  • Calendar
  • Deals (partial implementation)
  • Domains
  • Email Events (partial implementation)
  • Engagements (partial implementation)
  • Forms (partial implementation)
  • HubDB (partial implementation)
  • Layouts
  • Page Publishing
  • Social (partial implementation)
  • Workflows

Please check out the full documentation available at


At the moment of writing the HubSpot APIs do not support CORS / AJAX requests due to security reasons, so you must use this library only on a Node.js server.

Authors and Contributors

Currently maintained by the lovely folks on HubSpot's Web Team, but we need your help. Please feel free to submit pull requests to add new functionality.

How to Contribute

Contributions are welcome. Please refer to the contributing guidelines

You can’t perform that action at this time.