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 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.

Account

Function name	Description	Type	Source code
`fetch-account-information`	Retrieve portal account details, currency settings, timezone, and hosting region	Action	🔗 Github

Associations

Function name	Description	Type	Source code
`create-association`	Associate two records together	Action	🔗 Github

CRM

Function name	Description	Type	Source code
`fetch-custom-objects`	Retrieve HubSpot custom object schemas for enterprise accounts	Action	🔗 Github
`fetch-properties`	List CRM property metadata for a specified HubSpot object type	Action	🔗 Github

Companies

Function name	Description	Type	Source code
`batch-create-companies`	Create multiple companies at once	Action	🔗 Github
`batch-update-companies`	Update multiple companies at once	Action	🔗 Github
`create-company`	Create a company record	Action	🔗 Github
`delete-company`	Delete a company record	Action	🔗 Github
`get-company`	Get a company by ID	Action	🔗 Github
`list-companies`	List company records	Action	🔗 Github
`search-companies`	Search companies by criteria	Action	🔗 Github
`update-company`	Update a company record	Action	🔗 Github
`companies`	Sync companies from HubSpot CRM	Sync	🔗 Github

Contacts

Function name	Description	Type	Source code
`create-contact`	Create a contact record	Action	🔗 Github
`delete-contact`	Delete a contact record	Action	🔗 Github
`get-contact`	Get a contact by ID	Action	🔗 Github
`list-contacts`	List contact records	Action	🔗 Github
`update-contact`	Update a contact record	Action	🔗 Github
`contacts`	Sync contacts	Sync	🔗 Github

Deals

Function name	Description	Type	Source code
`create-deal`	Create a deal record in HubSpot	Action	🔗 Github
`delete-deal`	Delete a deal record	Action	🔗 Github
`get-deal`	Get a deal by ID	Action	🔗 Github
`list-deals`	List deal records from HubSpot CRM	Action	🔗 Github
`search-deals`	Search deals by criteria	Action	🔗 Github
`update-deal`	Update a deal record in HubSpot CRM	Action	🔗 Github
`deals`	Sync deals with amount, close date, stage, owner, description, and associated companies and contacts	Sync	🔗 Github

Forms

Function name	Description	Type	Source code
`list-forms`	List forms	Action	🔗 Github

Marketing

Function name	Description	Type	Source code
`get-marketing-email`	Get a marketing email by ID	Action	🔗 Github
`list-marketing-emails`	List marketing emails	Action	🔗 Github

Marketing Emails

Function name	Description	Type	Source code
`clone-marketing-email`	Clone an existing marketing email	Action	🔗 Github
`create-marketing-email`	Create a marketing email in HubSpot	Action	🔗 Github
`delete-marketing-email`	Delete a marketing email	Action	🔗 Github
`update-marketing-email`	Update a marketing email	Action	🔗 Github
`marketing-emails`	Sync marketing emails from HubSpot	Sync	🔗 Github

Notes

Function name	Description	Type	Source code
`create-note`	Create a HubSpot note with body, timestamp, owner, optional attachments, and an explicit association to a contact, company, deal, or ticket.	Action	🔗 Github

Owners

Function name	Description	Type	Source code
`get-owner`	Get an owner by ID	Action	🔗 Github
`owners`	Sync HubSpot owners with names, email, user IDs, and archive status	Sync	🔗 Github

Pipelines

Function name	Description	Type	Source code
`fetch-pipelines`	List pipelines and stages for an object type, defaulting to deals	Action	🔗 Github

Products

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

Properties

Function name	Description	Type	Source code
`create-property`	Create a custom CRM property for a specified HubSpot object type	Action	🔗 Github

Tasks

Function name	Description	Type	Source code
`create-task`	Create a HubSpot task with type, title, priority, assignee, due date, notes, and optional associations to contacts, companies, or deals	Action	🔗 Github
`delete-task`	Delete a HubSpot task by record ID	Action	🔗 Github
`update-task`	Update a HubSpot task’s fields, owner, due date, and associations	Action	🔗 Github
`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
`create-ticket`	Create a support ticket in HubSpot CRM	Action	🔗 Github
`delete-ticket`	Delete a support ticket	Action	🔗 Github
`get-ticket`	Get a ticket by ID	Action	🔗 Github
`list-tickets`	List support tickets	Action	🔗 Github
`search-tickets`	Search tickets by criteria	Action	🔗 Github
`update-ticket`	Update a support ticket	Action	🔗 Github
`service-tickets`	Sync service tickets with subject, content, owner, pipeline, stage, category, and priority	Sync	🔗 Github

Users

Function name	Description	Type	Source code
`change-user-role`	Update a HubSpot user’s role and team assignments	Action	🔗 Github
`create-user`	Provision a HubSpot user with email, role, and team assignments	Action	🔗 Github
`delete-user`	Delete a HubSpot provisioned user by ID	Action	🔗 Github
`fetch-roles`	List available user roles for a HubSpot enterprise account	Action	🔗 Github
`whoami`	Retrieve the current authenticated HubSpot user’s ID and email	Action	🔗 Github
`users`	Sync provisioned users with role IDs, primary team, and admin status	Sync	🔗 Github

Workflows

Function name	Description	Type	Source code
`delete-a-workflow`	Delete an automation workflow	Action	🔗 Github

​🚀 Quickstart

​📚 Hubspot Integration Guides

​🧩 Pre-built syncs & actions for Hubspot

​Account

​Associations

​CRM

​Companies

​Contacts

​Deals

​Forms

​Marketing

​Marketing Emails

​Notes

​Owners

​Pipelines

​Products

​Properties

​Tasks

​Tickets

​Users

​Workflows