Hubspot

Integrate your application with the Hubspot API

🚀 Quickstart

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

Create the integration

In Tenklo (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 Environment API key, integration ID, and connection ID:

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

Or fetch credentials with the Node SDK or API.

✅ You're connected! Check the Logs tab in Tenklo to inspect requests.

Implement Tenklo in your app

Follow our Auth implementation guide to integrate Tenklo in your app.

To obtain your own production credentials, follow the setup guide linked below.

HubSpot Marketplace installation flow is not supported. Tenklo only supports the standard OAuth flow — all connections must be initiated through Tenklo (e.g. via the Connect UI or the Tenklo 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.

Deleting a connection revokes its HubSpot refresh token by default. If multiple Tenklo connections share the same HubSpot refresh token, deleting one of them would revoke that token for all connections using it. To opt out of this for a given connection, set skipTokenRevocation: true in that connection's metadata using the update connection metadata endpoint before deleting it.

📚 Hubspot Integration Guides

Tenklo maintained guides for common use cases.

Official docs: Hubspot API docs

🧩 Pre-built syncs & actions for Hubspot

Explore Nango-provided actions in your dashboard. Extend and customize them to fit your needs.

Companies

Function nameDescriptionTypeSource code
companiesSync companies from HubSpot CRMSync🔗 Github

Contacts

Function nameDescriptionTypeSource code
contactsSync contactsSync🔗 Github

Deals

Function nameDescriptionTypeSource code
dealsSync deals with amount, close date, stage, owner, description, and associated companies and contactsSync🔗 Github

Marketing Emails

Function nameDescriptionTypeSource code
marketing-emailsSync marketing emails from HubSpotSync🔗 Github

Owners

Function nameDescriptionTypeSource code
ownersSync HubSpot owners with names, email, user IDs, and archive statusSync🔗 Github

Products

Function nameDescriptionTypeSource code
productsSync product records with pricing, SKU, quantity, and billing detailsSync🔗 Github

Tasks

Function nameDescriptionTypeSource code
tasksSync tasks with type, title, priority, assignee, due date, notes, and related contacts, companies, and dealsSync🔗 Github

Tickets

Function nameDescriptionTypeSource code
service-ticketsSync service tickets with subject, content, owner, pipeline, stage, category, and prioritySync🔗 Github

Users

Function nameDescriptionTypeSource code
usersSync provisioned users with role IDs, primary team, and admin statusSync🔗 Github

Others

Function nameDescriptionTypeSource code
batch-create-companiesCreate multiple companies at onceAction🔗 Github
batch-update-companiesUpdate multiple companies at onceAction🔗 Github
change-user-roleUpdate a HubSpot user's role and team assignmentsAction🔗 Github
clone-marketing-emailClone an existing marketing emailAction🔗 Github
create-associationAssociate two records togetherAction🔗 Github
create-companyCreate a company recordAction🔗 Github
create-contactCreate a contact recordAction🔗 Github
create-dealCreate a deal record in HubSpotAction🔗 Github
create-marketing-emailCreate a marketing email in HubSpotAction🔗 Github
create-noteCreate a HubSpot note with body, timestamp, owner, optional attachments, and an explicit association to a contact, company, deal, or ticket.Action🔗 Github
create-propertyCreate a custom CRM property for a specified HubSpot object typeAction🔗 Github
create-taskCreate a HubSpot task with type, title, priority, assignee, due date, notes, and optional associations to contacts, companies, or dealsAction🔗 Github
create-ticketCreate a support ticket in HubSpot CRMAction🔗 Github
create-userProvision a HubSpot user with email, role, and team assignmentsAction🔗 Github
delete-a-workflowDelete an automation workflowAction🔗 Github
delete-companyDelete a company recordAction🔗 Github
delete-contactDelete a contact recordAction🔗 Github
delete-dealDelete a deal recordAction🔗 Github
delete-marketing-emailDelete a marketing emailAction🔗 Github
delete-taskDelete a HubSpot task by record IDAction🔗 Github
delete-ticketDelete a support ticketAction🔗 Github
delete-userDelete a HubSpot provisioned user by IDAction🔗 Github
fetch-account-informationRetrieve portal account details, currency settings, timezone, and hosting regionAction🔗 Github
fetch-custom-objectsRetrieve HubSpot custom object schemas for enterprise accountsAction🔗 Github
fetch-pipelinesList pipelines and stages for an object type, defaulting to dealsAction🔗 Github
fetch-propertiesList CRM property metadata for a specified HubSpot object typeAction🔗 Github
fetch-rolesList available user roles for a HubSpot enterprise accountAction🔗 Github
get-companyGet a company by IDAction🔗 Github
get-contactGet a contact by IDAction🔗 Github
get-dealGet a deal by IDAction🔗 Github
get-marketing-emailGet a marketing email by IDAction🔗 Github
get-ownerGet an owner by IDAction🔗 Github
get-ticketGet a ticket by IDAction🔗 Github
list-companiesList company recordsAction🔗 Github
list-contactsList contact recordsAction🔗 Github
list-dealsList deal records from HubSpot CRMAction🔗 Github
list-formsList formsAction🔗 Github
list-marketing-emailsList marketing emailsAction🔗 Github
list-ticketsList support ticketsAction🔗 Github
search-companiesSearch companies by criteriaAction🔗 Github
search-dealsSearch deals by criteriaAction🔗 Github
search-ticketsSearch tickets by criteriaAction🔗 Github
update-companyUpdate a company recordAction🔗 Github
update-contactUpdate a contact recordAction🔗 Github
update-dealUpdate a deal record in HubSpot CRMAction🔗 Github
update-marketing-emailUpdate a marketing emailAction🔗 Github
update-taskUpdate a HubSpot task's fields, owner, due date, and associationsAction🔗 Github
update-ticketUpdate a support ticketAction🔗 Github
whoamiRetrieve the current authenticated HubSpot user's ID and emailAction🔗 Github

On this page