Hubspot - Nango Docs

🚀 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 Marketplace installation flow is not supported. Nango only supports the standard OAuth flow — all connections must be initiated through Nango (e.g. via the Connect UI or the Nango Auth API). If your HubSpot app is listed on the HubSpot Marketplace, users must connect through your Nango-powered flow, not via the Marketplace install button.

📚 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
`companies`	Sync companies from HubSpot CRM	Sync	🔗 Github

Contacts

Function name	Description	Type	Source code
`contacts`	Sync contacts	Sync	🔗 Github

Deals

Function name	Description	Type	Source code
`deals`	Sync deals with amount, close date, stage, owner, description, and associated companies and contacts	Sync	🔗 Github

Marketing Emails

Function name	Description	Type	Source code
`marketing-emails`	Sync marketing emails from HubSpot	Sync	🔗 Github

Owners

Function name	Description	Type	Source code
`owners`	Sync HubSpot owners with names, email, user IDs, and archive status	Sync	🔗 Github

Products

Function name	Description	Type	Source code
`products`	Sync product records with pricing, SKU, quantity, and billing details	Sync	🔗 Github

Tasks

Function name	Description	Type	Source code
`tasks`	Sync tasks with type, title, priority, assignee, due date, notes, and related contacts, companies, and deals	Sync	🔗 Github

Tickets

Function name	Description	Type	Source code
`service-tickets`	Sync service tickets with subject, content, owner, pipeline, stage, category, and priority	Sync	🔗 Github

Users

Function name	Description	Type	Source code
`users`	Sync provisioned users with role IDs, primary team, and admin status	Sync	🔗 Github

​🚀 Quickstart

​📚 Hubspot Integration Guides

​🧩 Pre-built syncs & actions for Hubspot

​Companies

​Contacts

​Deals

​Marketing Emails

​Owners

​Products

​Tasks

​Tickets

​Users

🚀 Quickstart

📚 Hubspot Integration Guides

🧩 Pre-built syncs & actions for Hubspot

Companies

Contacts

Deals

Marketing Emails

Owners

Products

Tasks

Tickets

Users