Hubspot

🚀 Quickstart

Connect to Hubspot with Nango and see data flow in 2 minutes.

Create the integration

In Nango (free signup), go to Integrations -> Configure New Integration -> Hubspot.

Authorize Hubspot

Go to Connections -> Add Test Connection -> Authorize, then log in to Hubspot. Later, you’ll let your users do the same directly from your app.

Call the Hubspot API

Let’s make your first request to the Hubspot API (fetch a list of contacts). Replace the placeholders below with your secret key, integration ID, and connection ID:

cURL
Node

curl "https://api.nango.dev/proxy/crm/v3/objects/contacts?properties=email,phone" \
  -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>"

Install Nango’s backend SDK with npm i @nangohq/node. Then run:

import { Nango } from '@nangohq/node';

const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

const res = await nango.get({
    endpoint: '/crm/v3/objects/contacts',
    params: { properties: "email,phone" },
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<CONNECTION-ID>'
});

console.log(res.data);

Or fetch credentials with the Node SDK or API.✅ You’re connected! Check the Logs tab in Nango to inspect requests.

Implement Nango in your app

Follow our Auth implementation guide to integrate Nango in your app.To obtain your own production credentials, follow the setup guide linked below.

📚 Hubspot Integration Guides

Nango maintained guides for common use cases.

How to register your own Hubspot OAuth app
Register an OAuth app with Hubspot and obtain credentials to connect it to Nango

Official docs: Hubspot API docs

🧩 Pre-built syncs & actions for Hubspot

Enable them in your dashboard. Extend and customize to fit your needs.

Companies

Function name	Description	Type	Source code
`create-company`	Create a single company in Hubspot	Action	🔗 Github
`delete-company`	Deletes a company in Hubspot	Action	🔗 Github
`update-company`	Update a single company in Hubspot	Action	🔗 Github
`companies`	Fetches a list of companies from Hubspot	Sync	🔗 Github

Contacts

Function name	Description	Type	Source code
`create-contact`	Create a single contact in Hubspot	Action	🔗 Github
`delete-contact`	Deletes a contact in Hubspot	Action	🔗 Github
`update-contact`	Updates a single contact in Hubspot	Action	🔗 Github
`contacts`	Fetches a list of contacts from Hubspot	Sync	🔗 Github

Deals

Function name	Description	Type	Source code
`create-deal`	Creates a single deal in Hubspot	Action	🔗 Github
`delete-deal`	Deletes a deal in Hubspot	Action	🔗 Github
`update-deal`	Updates a single deal in Hubspot	Action	🔗 Github
`deals`	Fetches a list of deals from Hubspot with their associated companies and contacts	Sync	🔗 Github

Owners

Function name	Description	Type	Source code
`owners`	Fetches a list of owners from Hubspot	Sync	🔗 Github

Pipelines

Function name	Description	Type	Source code
`fetch-pipelines`	Fetch all pipelines for an object type. Defaults to deals	Action	🔗 Github

Products

Function name	Description	Type	Source code
`products`	Fetches a list of products from Hubspot	Sync	🔗 Github

Properties

Function name	Description	Type	Source code
`create-property`	Create a property in Hubspot	Action	🔗 Github
`fetch-properties`	Fetch the properties of a specified object	Action	🔗 Github

Roles

Function name	Description	Type	Source code
`change-user-role`	Change a user role. Requires an enterprise account.	Action	🔗 Github
`fetch-roles`	Fetch the roles on an account. Requires an enterprise account.	Action	🔗 Github

Tasks

Function name	Description	Type	Source code
`create-task`	Creates a single task in Hubspot	Action	🔗 Github
`delete-task`	Deletes a task in Hubspot	Action	🔗 Github
`update-task`	Updates a single company in Hubspot	Action	🔗 Github
`tasks`	Fetches a list of tasks from Hubspot	Sync	🔗 Github

Users

Function name	Description	Type	Source code
`create-user`	Creates a single user in Hubspot	Action	🔗 Github
`delete-user`	Deletes a user in Hubspot	Action	🔗 Github
`whoami`	Fetch current user information	Action	🔗 Github
`users`	Fetches a list of users from Hubspot	Sync	🔗 Github

Others

Function name	Description	Type	Source code
`create-note`	Creates a single note in Hubspot	Action	🔗 Github
`fetch-account-information`	Fetch the account information from Hubspot	Action	🔗 Github
`fetch-custom-objects`	Fetch custom objects in Hubspot. Requires Hubspot enterprise	Action	🔗 Github
`currency-codes`	Fetch hubspot deals	Sync	🔗 Github
`knowledge-base`	Fetches a list of knowledge base from Hubspot	Sync	🔗 Github
`service-tickets`	Fetches a list of service tickets from Hubspot	Sync	🔗 Github

API Guides

APIs & Integrations

🚀 Quickstart

📚 Hubspot Integration Guides

🧩 Pre-built syncs & actions for Hubspot

Companies

Contacts

Deals

Owners

Pipelines

Products

Properties

Roles

Tasks

Users

Others

API Guides

APIs & Integrations

​🚀 Quickstart

​📚 Hubspot Integration Guides

​🧩 Pre-built syncs & actions for Hubspot

​Companies

​Contacts

​Deals

​Owners

​Pipelines

​Products

​Properties

​Roles

​Tasks

​Users

​Others

🚀 Quickstart

📚 Hubspot Integration Guides

🧩 Pre-built syncs & actions for Hubspot

Companies

Contacts

Deals

Owners

Pipelines

Products

Properties

Roles

Tasks

Users

Others