SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

How to integrate HubSpot MCP with LlamaIndex

Connect LlamaIndex to HubSpot MCP. Archive a batch of outdated contact records, associate a web form with current campaign, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
HubSpot logoHubSpot
Oauth2Api Key

HubSpot is an all-in-one marketing, sales, and customer service platform. It lets teams nurture leads, automate outreach, and track every customer interaction in one place.

343 Tools2 Triggers

Introduction

This guide walks you through connecting HubSpot to LlamaIndex using the Composio tool router. By the end, you'll have a working HubSpot agent that can manage contacts and companies, track deals, log notes and tasks, send marketing emails, and handle support tickets through natural language commands.

This guide will help you understand how to give your LlamaIndex agent real control over a HubSpot account through Composio's HubSpot MCP server.

Before we dive in, let's take a quick look at the key ideas and tools involved.

Also integrate HubSpot with

Claude CodeCursorChatGPTClaude CoworkAntigravityOpenAI Agents SDKClaude Agent SDKGrok BotMuseCodexKimi CodeGrok BuildVS CodeOpenCodeOpenClawHermesAtomic AgentCLIGoogle ADKLangChainVercel AI SDKMastra AICrewAIPydantic AIAutoGen

TL;DR

Here's what you'll learn:
  • Set your OpenAI and Composio API keys
  • Install LlamaIndex and Composio packages
  • Create a Composio Tool Router session for HubSpot
  • Connect LlamaIndex to the HubSpot MCP server
  • Build a HubSpot-powered agent using LlamaIndex
  • Interact with HubSpot through natural language

What is LlamaIndex?

LlamaIndex is a data framework for building LLM applications. It provides tools for connecting LLMs to external data sources and services through agents and tools.

Key features include:

  • ReAct Agent: Reasoning and acting pattern for tool-using agents
  • MCP Tools: Native support for Model Context Protocol
  • Context Management: Maintain conversation context across interactions
  • Async Support: Built for async/await patterns

What is the HubSpot MCP server, and what's possible with it?

The HubSpot MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your HubSpot account. It provides structured and secure access to your CRM records, activities, and pipelines, so your agent can create contacts and deals, record meetings, create tickets and products, review activities, and connect related records on your behalf.

  • Contact, company, and deal creation: Have your agent create contacts, companies, deals, tickets, or other CRM records from plain-language instructions.
  • Meeting and activity tracking: Let the agent record meetings and review calls, emails, meetings, notes, or tasks linked to companies and deals.
  • Ticket and product creation: Direct your agent to create customer support tickets in batches or add new products to your HubSpot catalog.
  • Record relationship management: Instruct your agent to connect related CRM records and review existing relationships between deals, contacts, and companies.
  • Pipeline and account visibility: Have your agent review changes to pipeline stages and confirm which HubSpot account is currently connected.

What is the Composio tool router, and how does it fit here?

What is Composio SDK?

Composio's Composio SDK helps agents find the right tools for a task at runtime. You can plug in multiple toolkits (like Gmail, HubSpot, and GitHub), and the agent will identify the relevant app and action to complete multi-step workflows. This can reduce token usage and improve the reliability of tool calls. Read more here: Getting started with Composio SDK

The tool router generates a secure MCP URL that your agents can access to perform actions.

How the Composio SDK works

The Composio SDK follows a three-phase workflow:

  1. Discovery: Searches for tools matching your task and returns relevant toolkits with their details.
  2. Authentication: Checks for active connections. If missing, creates an auth config and returns a connection URL via Auth Link.
  3. Execution: Executes the action using the authenticated connection.

Step-by-step Guide

Step by step10 STEPS
1

Prerequisites

Before you begin, make sure you have:
  • Python 3.8/Node 16 or higher installed
  • A Composio account with the API key
  • An OpenAI API key
  • A HubSpot account and project
  • Basic familiarity with async Python/Typescript
2

Getting API Keys for OpenAI, Composio, and HubSpot

OpenAI API key (OPENAI_API_KEY)
  • Go to the OpenAI dashboard
  • Create an API key if you don't have one
  • Assign it to OPENAI_API_KEY in .env
Composio API key and user ID
  • Log into the Composio dashboard
  • Copy your API key from Settings
    • Use this as COMPOSIO_API_KEY
  • Pick a stable user identifier (email or ID)
    • Use this as COMPOSIO_USER_ID
3

Installing dependencies

npm install @composio/llamaindex @llamaindex/openai @llamaindex/tools @llamaindex/workflow dotenv

Create a new Typescript project and install the necessary dependencies:

  • @composio/llamaindex: Composio's LlamaIndex integration
  • @llamaindex/openai: OpenAI LLM integration
  • @llamaindex/tools: MCP client for LlamaIndex
  • @llamaindex/workflow: Workflow framework for LlamaIndex
  • dotenv: Environment variable management
4

Set environment variables

bash
OPENAI_API_KEY=your-openai-api-key
COMPOSIO_API_KEY=your-composio-api-key
COMPOSIO_USER_ID=your-user-id

Create a .env file in your project root:

These credentials will be used to:

  • Authenticate with OpenAI's GPT-5 model
  • Connect to Composio's Tool Router
  • Identify your Composio user session for HubSpot access
5

Import modules

import "dotenv/config";
import readline from "node:readline/promises";
import { stdin as input, stdout as output } from "node:process";

import { Composio } from "@composio/core";

import { mcp } from "@llamaindex/tools";
import { agent as createAgent } from "@llamaindex/workflow";
import { openai } from "@llamaindex/openai";

dotenv.config();

Create a new file called hubspot_llamaindex_agent.ts and import the required modules:

Key imports:

  • dotenv.config loads .env at runtime
  • readline gives us a simple CLI chat loop
  • Composio is the main Composio SDK client
  • mcp connects to an MCP endpoint
  • createAgent builds a LlamaIndex agent
  • openai configures the LLM backend
6

Load environment variables and initialize Composio

const OPENAI_API_KEY = process.env.OPENAI_API_KEY;
const COMPOSIO_API_KEY = process.env.COMPOSIO_API_KEY;
const COMPOSIO_USER_ID = process.env.COMPOSIO_USER_ID;

if (!OPENAI_API_KEY) throw new Error("OPENAI_API_KEY is not set");
if (!COMPOSIO_API_KEY) throw new Error("COMPOSIO_API_KEY is not set");
if (!COMPOSIO_USER_ID) throw new Error("COMPOSIO_USER_ID is not set");

What's happening:

This ensures missing credentials cause early, clear errors before the agent attempts to initialise.

7

Create a Tool Router session and build the agent function

async function buildAgent() {

  console.log(`Initializing Composio client...${COMPOSIO_USER_ID!}...`);
  console.log(`COMPOSIO_USER_ID: ${COMPOSIO_USER_ID!}...`);

  const composio = new Composio({
    apiKey: COMPOSIO_API_KEY,
    provider: new LlamaindexProvider(),
  });

  const session = await composio.create(
    COMPOSIO_USER_ID!,
    {
      toolkits: ["hubspot"],
    },
  );

  const mcpUrl = session.mcp.url;
  console.log(`Composio Tool Router MCP URL: ${mcpUrl}`);

  const server = mcp({
    url: mcpUrl,
    clientName: "composio_tool_router_with_llamaindex",
    requestInit: {
      headers: {
        "x-api-key": COMPOSIO_API_KEY!,
      },
    },
    // verbose: true,
  });

  const tools = await server.tools();

  const llm = openai({ apiKey: OPENAI_API_KEY, model: "gpt-5" });

  const agent = createAgent({
    name: "composio_tool_router_with_llamaindex",
        description : "An agent that uses Composio Tool Router MCP tools to perform actions.",
    systemPrompt:
      "You are a helpful assistant connected to Composio Tool Router."+
"Use the available tools to answer user queries and perform HubSpot actions." ,
    llm,
    tools,
  });

  return agent;
}

What's happening here:

  • We create a Composio client using your API key and configure it with the LlamaIndex provider
  • We then create a tool router MCP session for your user, specifying the toolkits we want to use (in this case, hubspot)
  • The session returns an MCP HTTP endpoint URL that acts as a gateway to all your configured tools
  • LlamaIndex will connect to this endpoint to dynamically discover and use the available HubSpot tools.
  • The MCP tools are mapped to LlamaIndex-compatible tools and plug them into the Agent.
8

Create an interactive chat loop

async function chatLoop(agent: ReturnType<typeof createAgent>) {
  const rl = readline.createInterface({ input, output });

  console.log("Type 'quit' or 'exit' to stop.");

  while (true) {
    let userInput: string;

    try {
      userInput = (await rl.question("\nYou: ")).trim();
    } catch {
      console.log("\nAgent: Bye!");
      break;
    }

    if (!userInput) {
      continue;
    }

    const lower = userInput.toLowerCase();
    if (lower === "quit" || lower === "exit") {
      console.log("Agent: Bye!");
      break;
    }

    try {
      process.stdout.write("Agent: ");

      const stream = agent.runStream(userInput);
      let finalResult: any = null;

      for await (const event of stream) {
        // The event.data contains the streamed content
        const data: any = event.data;

        // Check for streaming delta content
        if (data?.delta) {
          process.stdout.write(data.delta);
        }

        // Store final result for fallback
        if (data?.result || data?.message) {
          finalResult = data;
        }
      }

      // If no streaming happened, show the final result
      if (finalResult) {
        const answer =
          finalResult.result ??
          finalResult.message?.content ??
          finalResult.message ??
          "";
        if (answer && typeof answer === "string" && !answer.includes("[object")) {
          process.stdout.write(answer);
        }
      }

      console.log(); // New line after streaming completes
    } catch (err: any) {
      console.error("\nAgent error:", err?.message ?? err);
    }
  }

  rl.close();
}

What's happening:

  • We're creating a direct terminal interface to chat with HubSpot
  • The LLM's responses are streamed to the CLI for faster interaction.
  • The agent uses context to maintain conversation history
  • The agent processes the request, selects appropriate HubSpot tools, and returns a result
  • We extract the answer from the result data structure and display it to the user
  • You can type 'quit' or 'exit' to stop the chat loop gracefully
  • Agent responses and any errors are streamed in a clear, readable format
9

Define the main entry point

async function main() {
  try {
    const agent = await buildAgent();
    await chatLoop(agent);
  } catch (err) {
    console.error("Failed to start agent:", err);
    process.exit(1);
  }
}

main();

What's happening here:

  • We're orchestrating the entire application flow
  • The agent gets built with proper error handling
  • Then we kick off the interactive chat loop so you can start talking to HubSpot
10

Run the agent

npx ts-node llamaindex-agent.ts

When prompted, authenticate and authorise your agent with HubSpot, then start asking questions.

Complete Code

Here's the complete code to get you started with HubSpot and LlamaIndex:

import "dotenv/config";
import readline from "node:readline/promises";
import { stdin as input, stdout as output } from "node:process";

import { Composio } from "@composio/core";
import { LlamaindexProvider } from "@composio/llamaindex";

import { mcp } from "@llamaindex/tools";
import { agent as createAgent } from "@llamaindex/workflow";
import { openai } from "@llamaindex/openai";

dotenv.config();

const OPENAI_API_KEY = process.env.OPENAI_API_KEY;
const COMPOSIO_API_KEY = process.env.COMPOSIO_API_KEY;
const COMPOSIO_USER_ID = process.env.COMPOSIO_USER_ID;

if (!OPENAI_API_KEY) {
    throw new Error("OPENAI_API_KEY is not set in the environment");
  }
if (!COMPOSIO_API_KEY) {
    throw new Error("COMPOSIO_API_KEY is not set in the environment");
  }
if (!COMPOSIO_USER_ID) {
    throw new Error("COMPOSIO_USER_ID is not set in the environment");
  }

async function buildAgent() {

  console.log(`Initializing Composio client...${COMPOSIO_USER_ID!}...`);
  console.log(`COMPOSIO_USER_ID: ${COMPOSIO_USER_ID!}...`);

  const composio = new Composio({
    apiKey: COMPOSIO_API_KEY,
    provider: new LlamaindexProvider(),
  });

  const session = await composio.create(
    COMPOSIO_USER_ID!,
    {
      toolkits: ["hubspot"],
    },
  );

  const mcpUrl = session.mcp.url;
  console.log(`Composio Tool Router MCP URL: ${mcpUrl}`);

  const server = mcp({
    url: mcpUrl,
    clientName: "composio_tool_router_with_llamaindex",
    requestInit: {
      headers: {
        "x-api-key": COMPOSIO_API_KEY!,
      },
    },
    // verbose: true,
  });

  const tools = await server.tools();

  const llm = openai({ apiKey: OPENAI_API_KEY, model: "gpt-5" });

  const agent = createAgent({
    name: "composio_tool_router_with_llamaindex",
    description:
      "An agent that uses Composio Tool Router MCP tools to perform actions.",
    systemPrompt:
      "You are a helpful assistant connected to Composio Tool Router."+
"Use the available tools to answer user queries and perform HubSpot actions." ,
    llm,
    tools,
  });

  return agent;
}

async function chatLoop(agent: ReturnType<typeof createAgent>) {
  const rl = readline.createInterface({ input, output });

  console.log("Type 'quit' or 'exit' to stop.");

  while (true) {
    let userInput: string;

    try {
      userInput = (await rl.question("\nYou: ")).trim();
    } catch {
      console.log("\nAgent: Bye!");
      break;
    }

    if (!userInput) {
      continue;
    }

    const lower = userInput.toLowerCase();
    if (lower === "quit" || lower === "exit") {
      console.log("Agent: Bye!");
      break;
    }

    try {
      process.stdout.write("Agent: ");

      const stream = agent.runStream(userInput);
      let finalResult: any = null;

      for await (const event of stream) {
        // The event.data contains the streamed content
        const data: any = event.data;

        // Check for streaming delta content
        if (data?.delta) {
          process.stdout.write(data.delta);
        }

        // Store final result for fallback
        if (data?.result || data?.message) {
          finalResult = data;
        }
      }

      // If no streaming happened, show the final result
      if (finalResult) {
        const answer =
          finalResult.result ??
          finalResult.message?.content ??
          finalResult.message ??
          "";
        if (answer && typeof answer === "string" && !answer.includes("[object")) {
          process.stdout.write(answer);
        }
      }

      console.log(); // New line after streaming completes
    } catch (err: any) {
      console.error("\nAgent error:", err?.message ?? err);
    }
  }

  rl.close();
}

async function main() {
  try {
    const agent = await buildAgent();
    await chatLoop(agent);
  } catch (err: any) {
    console.error("Failed to start agent:", err?.message ?? err);
    process.exit(1);
  }
}

main();

Conclusion

You've successfully connected HubSpot to LlamaIndex through Composio's Tool Router MCP layer. Key takeaways:
  • Tool Router dynamically exposes HubSpot tools through an MCP endpoint
  • LlamaIndex's ReActAgent handles reasoning and orchestration; Composio handles integrations
  • The agent becomes more capable without increasing prompt size
  • Async Python provides clean, efficient execution of agent workflows
You can easily extend this to other toolkits like Gmail, Notion, Stripe, GitHub, and more by adding them to the toolkits parameter.
TOOLS & TRIGGERS

Supported Tools and Triggers

Every HubSpot action and event your agent gets out of the box.

Add asset association

Associates an existing asset ('FORM', 'OBJECT_LIST', or 'EXTERNAL_WEB_URL') with a specified HubSpot marketing campaign.

Add token to event template

Adds a new custom data token to an existing event template for a specified HubSpot application, optionally populating a CRM object property if objectPropertyName is provided.

Archive batch of feedback submissions by id

Asynchronously archives a batch of HubSpot feedback submissions using their unique IDs, which must correspond to valid and existing submissions; the operation is queued, and submissions are moved from active views without being deleted.

Archive batch of line items by id

Archives a batch of existing line items by their unique IDs in HubSpot CRM; this operation is irreversible via the API.

Archive batch of objects by id

Archives a batch of existing, non-archived CRM objects of a specified `objectType` by their IDs, effectively hiding them from active use.

Archive batch of properties

Archives a batch of properties by their internal names for a specified HubSpot CRM object type; this operation is idempotent and safe to retry.

Archive a batch of quotes by id

Archives a batch of existing quotes by their IDs, removing them from active views while keeping them accessible in your HubSpot account for viewing, downloading, cloning, or deletion; note that archived quotes cannot be restored to active status.

Archive companies

Archives multiple HubSpot companies by their IDs.

Archive company

Archives an existing company in HubSpot CRM by its `companyId`, moving it to a recycling bin from which it can be restored, rather than permanently deleting it.

Archive contact

Archives a HubSpot contact by its ID.

Archive contacts

Archives multiple HubSpot contacts by their IDs.

Archive a CRM object by ID

Archives a specific HubSpot CRM object by its type and ID, moving it to the recycling bin; this action is irreversible via the API but objects can often be restored via the HubSpot UI.

Archive deals

Archives multiple HubSpot deals by their IDs.

ArchiveEmail email

Archives a HubSpot CRM email engagement by its numeric object ID, moving it to the recycling bin.

Archive emails

Archives multiple HubSpot CRM email engagement records by their IDs.

Archive feedback submission

Archives an existing, non-archived Feedback Submission in HubSpot CRM by its ID, moving it to the recycling bin (not permanently deleting it).

Archive line item by id

Archives a specific HubSpot line item by its ID, moving it to a recoverable state.

Archive product

Archives a HubSpot product by its ID.

Archive products

Archives multiple HubSpot products by their IDs.

Archive property by object type and name

Archives a specified CRM property by its object type and name, moving it to the recycling bin; note that some default HubSpot properties cannot be archived.

Archive property group

Archives a HubSpot property group, making it inactive and hidden (not permanently deleted, allowing potential restoration) with immediate effect on its CRM visibility and usability.

Archive quote object by id

Archives a HubSpot Quote object by ID, moving it to the recycling bin where it can be restored within 90 days.

Archive ticket

Archives a HubSpot ticket by its ID.

Archive tickets

Archives multiple HubSpot tickets by their IDs.

Audit pipeline changes by id

Retrieves a reverse chronological audit log of all changes for a specific, existing HubSpot CRM pipeline, which is identified by its `pipelineId` and a valid `objectType` that supports pipelines (e.

Batch archive association labels

Remove selected labels from up to 100 HubSpot CRM association pairs.

Batch create contact-company associations

Creates up to 2,000 labeled contact-to-company associations.

Batch create deal-company associations

Creates labeled associations from deals to companies in one batch.

Batch create default associations

Create default unlabeled associations for batches of HubSpot CRM record pairs.

Batch read companies by properties

Batch-retrieves up to 100 HubSpot company records by their IDs in a single request.

Batch read list memberships

Retrieve list memberships for multiple HubSpot CRM records.

Batch read workflow ID mappings

Resolves current flow IDs and legacy workflow IDs in one batch.

Batch read workflows

Retrieves multiple HubSpot automation workflows by flow ID.

Batch update quotes

Updates multiple existing HubSpot quotes in a batch; each quote is identified by its object ID or a custom unique property (via `idProperty`), and only writable properties are modified.

Cancel active import

Cancels an active HubSpot data import job using its `importId`; this action is irreversible, and any data already processed will remain.

Clone marketing email

Duplicates an existing HubSpot marketing email, identified by its `id`, into a new draft; an optional `cloneName` can be assigned to this new email copy.

Configure calling extension settings

Configures or updates settings for a HubSpot app's calling extension, including its name, UI URL, iframe dimensions, `isReady` status, and `supportsCustomObjects` flag, for the specified `appId`.

Create A/B test variation

Creates a new A/B test variation for an existing HubSpot marketing email, using its `contentId`; the new variation is created as a draft that can be edited before publishing.

Create a new property group

Creates a new, empty property group for a specified CRM object type in HubSpot, requiring a unique group name for that object type; properties must be added separately.

Create a new marketing email

Creates a new marketing email in HubSpot, allowing comprehensive configuration of content, recipients, sender details, A/B testing, scheduling, web version, and other settings; the internal `name` for the email is required.

Create association for object type

Creates a new custom association definition (schema) for a custom object in HubSpot, specifying how this object type can relate to another object type; this defines the association type itself, not actual record-to-record links.

Create association label

Create a custom relationship-label definition between two CRM object types.

Create batch of feedback submissions

Creates a batch of feedback submissions in HubSpot, ideal for bulk imports; all property names, `associationTypeId`s, and association `to_id`s must reference existing entities in HubSpot.

Create batch of objects

Creates multiple CRM objects of a specified `objectType` (e.

Create batch of properties

Efficiently creates multiple CRM properties in a single batch for a specified HubSpot object type (e.

Create batch of quotes

Creates multiple HubSpot CRM quotes in a batch, ideal for bulk operations; provide meaningful quote details in `inputs` as property requirements can vary, and inspect response for individual quote statuses as partial success is possible.

Create blog post

Create a HubSpot CMS blog post, defaulting to a draft.

Create campaign

Creates a new HubSpot campaign.

Create campaigns

Creates multiple HubSpot campaigns by calling the single campaign creation endpoint for each campaign.

Create campaign spend item

Records a spend item against a HubSpot marketing campaign.

Create companies

Creates multiple new HubSpot companies in a single batch operation.

Create company

Creates a new HubSpot company.

Create contact

Creates a new HubSpot contact.

Create Contact From Natural Language

Creates a HubSpot contact from a natural language description, using the contact property schema and an LLM-generated property payload.

Create contacts

Creates multiple HubSpot contacts in a batch, with contact properties and optional associations to existing CRM records.

Create content template

Create a HubSpot Design Manager template from HubL or HTML source.

Create CRM Object From Natural Language

Creates a HubSpot CRM record from a natural-language description, including contacts, deals, companies, tickets, and custom objects.

Create CRM object with properties

Creates a new HubSpot CRM object (e.

Create deal

Creates a new HubSpot deal.

Create Deal From Natural Language

Creates a HubSpot deal from a natural language description using an LLM and the deal property schema.

Create deals

Creates multiple deals in HubSpot CRM; ensure any associated object IDs, deal stages, and pipeline IDs specified are valid and exist within the HubSpot account.

Create default association

Create HubSpot's default unlabeled association between two CRM records.

Create email

Creates a new HubSpot email engagement record.

Create emails

Creates multiple HubSpot CRM email engagement records in a single batch operation using supplied email properties.

Create engagement

Create a legacy EMAIL, CALL, MEETING, TASK, or NOTE engagement with optional CRM associations, attachments, and type-specific metadata.

Create event template for app

Creates a new event template for a HubSpot app, defining structure, custom properties (tokens), and appearance (Markdown with Handlebars) of custom timeline events for CRM objects; this template must exist before logging corresponding events.

Create feedback submission

Creates a HubSpot feedback submission with properties and an associations list, which may be empty.

Create landing page

Create a HubSpot landing page, as a draft unless state is explicitly set.

Create line item

Creates a new HubSpot line item.

Create line items

Creates multiple HubSpot line items in a single batch operation.

Create list

Create a HubSpot CRM list with manual, snapshot, or dynamic membership rules.

Create meeting

Creates a new meeting engagement in HubSpot CRM.

Create note

Creates a new HubSpot CRM note.

Create object association

Tool to create or label an association between two CRM records using HubSpot Associations v4 API.

Create new object schema with custom properties

Creates a new custom object schema in HubSpot CRM with unique naming for schema and properties, defined display/required/searchable properties within the 'properties' list, provided immutable labels, and correctly configured 'enumeration' type properties (options/referencedObjectType).

Create or update draft version

Creates or updates the draft version of a marketing email identified by `emailId`; if no draft exists, a new one is created from the current live version to prepare changes or A/B tests before publishing.

Create pipeline for object type

Creates a new HubSpot pipeline for a specified CRM `objectType` (e.

Create pipeline stage

Creates a new stage in a specified HubSpot CRM pipeline for a given object type, such as 'deals' or 'tickets'.

Create product

Creates a new HubSpot product.

Create products

Creates multiple HubSpot products in a single batch operation.

Create property for specified object type

Creates a new custom property for a specified HubSpot CRM object type; ensure `groupName` refers to an existing property group for the `objectType`.

Create quote object

Creates a new quote object in HubSpot CRM with specified properties and associations.

Create site page

Create a HubSpot website page draft and return its complete page record.

Create task

Creates a new CRM task record.

Create ticket

Creates a new HubSpot ticket.

Create tickets

Creates multiple HubSpot tickets in a batch, each with its own properties and associations; `inputs` list must not be empty, each item needs `properties`, and associations/custom properties must be validly defined using internal names for custom fields and ISO 8601 for dates.

Create timeline event based on template

Creates an immutable custom timeline event on a CRM object's record using a specified, existing event template (identified by `eventTemplateId`), optionally updating CRM object properties if defined in the template; requires `email`, `utk`, or `objectId` for association.

Create multiple timeline events batch

Creates multiple immutable timeline events in a batch, ideal for bulk data imports or real-time synchronizations, using a valid event template; may update CRM properties if the template is so configured.

Create workflow

Creates a new HubSpot workflow to automate processes; ensure `enrollmentCriteria` and `actions` use properties relevant to the specified `objectTypeId`.

Delete association label

Delete one custom relationship-label definition between CRM object types.

Delete call

Deletes a HubSpot call record by its ID.

Delete calling extension settings

Deletes the settings for a calling extension app identified by its app ID.

Delete campaign

Permanently deletes a marketing campaign from HubSpot using its `campaignGuid`; returns a 204 No Content status even if the campaign does not exist.

Archive a batch of campaigns

Archives a batch of up to 50 marketing campaigns, hiding them from active views rather than permanently deleting them.

Permanently delete company for GDPR compliance

Permanently deletes a company (identified by objectId) and its associated data from HubSpot for GDPR compliance; this action is irreversible and requires the company to exist.

Permanently delete contact for GDPR compliance

Irreversibly erases a HubSpot contact and associated data per a GDPR request; if an email is given for a non-existent contact, it's blocklisted.

Delete CRM list

Soft-deletes a HubSpot CRM list by its ILS list ID.

Archive deal (GDPR permanent delete not supported for deals)

Archives a HubSpot deal by its ID.

Permanently delete line items for gdpr

Permanently deletes a specified line item and its associated content for GDPR compliance; this action is irreversible and cannot be undone.

Delete a marketing email

Permanently deletes a marketing email from your HubSpot account.

Delete meeting

Permanently deletes (archives) a HubSpot meeting by its ID, moving it to the recycling bin where it can be restored within 90 days.

Delete note

Archives a HubSpot note by its ID, removing it from active view.

Delete pipeline by id

Permanently deletes a HubSpot pipeline and all its stages by `pipelineId` and `objectType`; this is irreversible, so use validation flags to avoid errors if the pipeline is not empty.

Delete pipeline stage by id

Permanently deletes a specific pipeline stage for an `objectType` (e.

Delete schema by object type

Deletes a HubSpot custom object schema by `objectType`.

Delete task

Archives a HubSpot task by its ID, removing it from active task lists.

Delete timeline event template

Permanently and irreversibly deletes a specific timeline event template, identified by its `eventTemplateId`, from the application `appId`.

Delete video conferencing app settings

Deletes the settings for a specified HubSpot video conferencing application.

Delete workflow

Permanently deletes a HubSpot workflow by its ID; deleted workflows cannot be restored via the API and the ID must exist.

Download CMS source file

Download one file from HubSpot's CMS developer filesystem.

Enroll contact in workflow

Enrolls a contact, identified by email, in a HubSpot workflow.

Fetch import error details

Fetches a paginated list of read-only error details for a specific HubSpot CRM import, requiring a valid `importId` for a processed import.

Fetch recording settings by app ID

Fetches call recording settings for a specified, existing HubSpot calling extension app.

Fetch revenue

Fetches a revenue attribution report for a specified, existing marketing campaign, optionally using a specific attribution model and date range; if both start and end dates are given, `endDate` must not be earlier than `startDate`.

Get the variation of an A/B marketing email

Retrieves the alternate variation of a specified A/B marketing email; the `emailId` must identify an email currently in an A/B test.

Get Account Information

Retrieves current HubSpot account details, including the account ID, time zone, currencies, UI domain and data hosting location.

Get active imports list

Retrieves a list of currently active import jobs in HubSpot for monitoring ongoing data operations.

Get aggregated statistic intervals

Retrieves aggregated statistics for marketing emails (e.

Get aggregated statistics

Retrieves aggregated marketing email statistics for a time range, with optional email ID and property parameters.

Get all marketing emails for a HubSpot account

Fetches a list of marketing emails from a HubSpot account, with options for filtering, sorting, pagination, and including performance statistics.

Get blog post

Retrieves one HubSpot CMS blog post by post ID.

Get blog tag

Retrieves one HubSpot CMS blog tag by tag ID.

Get campaign

Retrieves a HubSpot campaign by its ID.

Get campaign metrics

Retrieves key attribution metrics for an existing marketing campaign, identified by its `campaignGuid`, within an optional date range.

Get campaigns

Retrieves multiple HubSpot campaigns.

Get CMS source metadata

Retrieves metadata for one HubSpot CMS source path.

Get communication status

Retrieves detailed HubSpot communication statuses for an email address.

Get company

Retrieves a HubSpot company by its ID.

Get contact IDs

Fetches a list of contact IDs for a specific HubSpot campaign based on interaction type.

Get contact workflow enrollments

Return the workflows in which a HubSpot contact is currently enrolled.

Get CRM export status

Retrieves the status and available result of a HubSpot CRM export task.

Get CRM list

Retrieves a HubSpot CRM list by its ILS list ID.

Get CRM list by name

Retrieves a HubSpot CRM list by object type and exact name.

Get CRM lists by IDs

Retrieves multiple HubSpot CRM lists by their current IDs.

Get deal

Retrieves a HubSpot deal by its ID.

Get deals

Retrieves multiple HubSpot deals by their IDs in a single batch request.

Get emails

Retrieves multiple HubSpot email engagement records by their IDs in a single batch request.

Get email subscription status

Retrieves legacy overall email delivery and subscription state for an address.

Get engagement

Retrieve one legacy aggregate engagement by its engagement ID.

Get specific event template for app

Retrieves detailed information about a specific event template for a given application in HubSpot's CRM timeline.

Get exchange rate

Retrieves one HubSpot account exchange rate by ID.

Get file

Retrieves one HubSpot file-manager record by file ID.

Get file import status

Retrieves the status and result of a HubSpot URL file import task.

Get file signed URL

Generates a temporary signed URL for one HubSpot file.

Get form

Retrieves one HubSpot marketing form definition by form ID.

Get import record information

Retrieves a HubSpot CRM import record by ID, including its status, metadata, and import configuration when available.

Get landing page

Retrieve one HubSpot CMS landing page by page ID.

Get landing page draft

Retrieve the full editable draft of one HubSpot landing page.

Get draft version of a marketing email

Retrieves the draft version of a marketing email by its `emailId`; if no draft exists, returns the published version.

Get a revision of a marketing email

Retrieves a specific, previously saved revision of a marketing email using its unique email ID and revision ID.

Get revisions of a marketing email

Retrieves a paginated list of all historical versions (including full state like content, settings, metadata) for a specified, existing marketing email; revision ID -1 identifies the current version.

Get marketing event participation breakdown

Pages participation records for one HubSpot marketing event.

Return pipeline by id

Retrieves a specific pipeline by its ID and CRM object type, detailing its stages and properties.

Get pipeline stage audit

Retrieves a reverse chronological list of all mutations (changes) for a specific pipeline stage, including CREATE and UPDATE events with timestamps and details.

Get private app daily API usage

Retrieve daily private-app API consumption and limits.

Get product

Retrieves a HubSpot product by its ID.

Get products

Retrieves multiple HubSpot products in a batch by their IDs or by values of a specified alternate unique identifier property.

Get quote by id

Retrieves a specific HubSpot quote by its unique identifier.

Get record list memberships

Return the HubSpot lists that contain one CRM record.

Get segment members

Tool to retrieve segment (list) members ordered by join timestamp.

Get settings user

Retrieves one HubSpot settings user by user ID or email.

Get site page

Retrieve one HubSpot site page by ID.

Get site page draft

Retrieve the full editable draft of one HubSpot site page.

Get the details of a specified marketing email

Retrieves detailed information for a specific marketing email in HubSpot using its unique email ID, optionally including performance statistics and specific properties.

Get ticket

Retrieves a HubSpot ticket by its ID.

Get tickets

Retrieves multiple HubSpot tickets in a batch by ticket IDs or values of an alternate unique identifier property.

Get workflow by ID

Retrieves a HubSpot workflow by ID.

Get workflow performance

Return enrolled, completed, and unenrolled workflow counts by time bucket.

Get workflow revision

Retrieves a specific historical revision of a HubSpot workflow.

Get all workflows

Retrieves workflow summaries from HubSpot in a single request, applying the limit locally to the returned list.

List all engagements

Lists one page from HubSpot's complete legacy aggregate engagement feed.

List assets

Lists assets of a specified type associated with a HubSpot marketing campaign, with pagination and optional date-range parameters.

List associated engagements

Lists one page of legacy engagements associated with a contact or company.

List association labels

Return v4 association labels for a directed pair of CRM object types.

List association types

Lists all valid association types between two specified HubSpot CRM object types.

List audit logs

Lists Enterprise-only HubSpot account audit logs with optional filters and pagination.

List automation flows

Lists HubSpot v4 automation flows with forward pagination.

List blog posts

Lists HubSpot CMS blog posts with documented filters and cursor pagination.

List call dispositions

Return HubSpot call disposition IDs and labels.

List companies

Retrieves a paginated list of HubSpot companies.

List company activities

Lists a page of activity associations for a HubSpot company and a specified activity type, such as calls, emails, meetings, notes, or tasks.

List company calls

Lists a page of call associations for a HubSpot company, returning call IDs and association types.

List company meetings

Lists a page of meetings associated with a HubSpot company, returning meeting IDs and association metadata.

List contact notes

Lists a page of notes associated with a HubSpot contact, returning note IDs and association metadata.

List contact properties

Lists all contact properties in your HubSpot account, including custom properties you've created.

List contacts

Retrieves a paginated list of HubSpot contacts.

List contact tasks

Lists a page of tasks associated with a HubSpot contact, returning task IDs and association metadata.

List content templates

Returns one offset-controlled page of HubSpot content templates.

List conversation channels

Lists HubSpot conversation channels with sorting and pagination.

List conversation inboxes

Lists HubSpot conversation inbox resources with cursor pagination.

List conversation threads

Lists HubSpot conversation threads with filtering and forward pagination.

List deal activities

Retrieves the first page of note, call, email, meeting, and task associations for a HubSpot deal, including activity IDs and association metadata.

List deal meetings

Lists a page of meetings associated with a HubSpot deal, returning meeting IDs and association metadata.

List deals

Retrieves a paginated list of HubSpot deals.

List domains

Return one cursor-controlled page of connected HubSpot CMS domains.

List email campaign IDs

Lists one paginated page of HubSpot email campaign IDs.

List email campaigns

Lists email-analytics campaign IDs ordered by recent activity.

List email events

Lists one page of HubSpot marketing email events; continue with `offset` only while `hasMore` is true.

List Emails

Retrieves a paginated list of HubSpot emails, allowing selection of specific properties (with or without history), associated object IDs, and filtering by archive status.

List event occurrences

Lists one page of HubSpot event occurrences matching optional filters.

List all event templates for app

Retrieves all event templates associated with a valid `appId` for an existing application in HubSpot's CRM Timeline.

List feedback submissions page

Retrieves a paginated list of HubSpot feedback submissions, with property selection and archive-status filtering.

List forms

Lists HubSpot marketing form definitions with cursor pagination.

List form submissions

Lists one cursor-paginated page of submissions for a HubSpot form.

List granted OAuth scopes

Tool to introspect the current OAuth access token and return its granted scopes and metadata.

List landing page revisions

Lists historical revisions of a HubSpot landing page.

List landing pages

Return one cursor-controlled page of HubSpot landing pages.

List login activity

Lists HubSpot account login attempts.

List object associations

Lists a page of associations from a single CRM record to a specified target object type without fetching the full CRM object.

List products

Retrieves a paginated list of HubSpot products.

List quotes page

Retrieves a paginated list of quotes, allowing selection of specific properties, property history, associated object IDs, and filtering by archived status.

List recently modified engagements

Lists one page of engagements from HubSpot's last-30-days or 10,000-most-recently-updated feed.

List sequences

Lists automation sequences for a specific HubSpot user.

List settings users

Lists HubSpot account users and their provisioning details.

List site pages

Return one cursor-controlled page of HubSpot website pages.

List teams

Lists HubSpot teams and their primary and secondary user memberships.

List tickets

Retrieves a paginated list of HubSpot tickets.

List user roles

Lists user roles available in the connected HubSpot account.

Map legacy list ID

Translates a legacy HubSpot list ID to its current list ID.

Merge two companies of same type

Merges two existing company records of the same type in HubSpot CRM, where `objectIdToMerge` is absorbed into `primaryObjectId`; this operation is irreversible.

Merge contacts

Merges two HubSpot contacts into one.

Merge deals

Merges two HubSpot deals into one.

Merge emails

Merges two HubSpot emails into one.

Merge two feedback submissions

Merges two existing feedback submissions by ID, primarily for consolidating duplicates or related feedback; this operation is irreversible, and `primaryObjectId` values take precedence in conflicts.

Merge two line items of same type

Merges two line items, `objectIdToMerge` into `primaryObjectId`, which must be of the same type; `objectIdToMerge` is absorbed and the operation is irreversible.

Merge two objects of same type

Merges two distinct HubSpot CRM objects of the same `objectType`, consolidating data into `primaryObjectId` (which is preserved) and deleting `objectIdToMerge`; this operation is permanent and irreversible.

Merge products

Merges two HubSpot products into one.

Merge two quotes of same type

Merges two distinct quotes of the same type by consolidating `objectIdToMerge` into `primaryObjectId` (e.

Merge tickets

Merges two HubSpot tickets into one.

Move list to folder

Move a HubSpot CRM list to a folder, including the root folder.

Partially update CRM object by ID

Partially updates specified properties of a CRM object (e.

Permanently delete contact via GDPR

Permanently deletes a HubSpot contact and all its associated data for GDPR compliance, identifying the contact by its ID or another unique property.

Publish landing page draft

Apply draft changes to the live version of a HubSpot landing page.

Publish or send a marketing email

Publishes or sends a specified HubSpot marketing email that is valid and ready for sending; requires Marketing Hub Enterprise or the transactional email add-on.

Publish site page draft

Apply draft changes to the live version of an already published HubSpot site page.

Read a CRM property by name

Reads a specific CRM property definition for a given HubSpot object type by its internal name.

Read all properties for object type

Retrieves definitions and metadata (not actual values) for properties of a specified HubSpot CRM object type (e.

Read a page of objects by type

Retrieves a paginated list of objects for a specified and valid HubSpot CRM object type (e.

Batch read associations

Tool to batch-read CRM associations (e.

Read a batch of CRM object properties

Retrieves property definitions (metadata) for a batch of CRM object properties for a specified object type.

Read batch feedback submissions by id or property

Retrieves up to 100 feedback submissions in a batch using their IDs or a specified unique `idProperty`, optionally including specified properties and their history.

Read batch of crm objects by id or property values

Reads a batch of CRM objects of a specified `objectType` using their HubSpot IDs or unique property values from the `inputs` list, allowing retrieval of specific `properties`, their historical values (`propertiesWithHistory`), and filtering by `archived` status.

Read batch of line items by id or property values

Retrieves a batch of HubSpot CRM line items by their IDs, or optionally by values of a custom unique property defined in `idProperty`.

Read batch of quotes by property values

Efficiently retrieves a batch of HubSpot CRM quotes by their IDs (or a specified unique property), optionally including archived quotes, specific properties, and property history.

Read budget

Retrieves budget totals for a specified HubSpot marketing campaign by its campaign ID.

Read contact

Retrieves a HubSpot contact by its ID.

Read contacts

Batch read multiple HubSpot contacts by their IDs or custom identifier property.

Read crm object by id

Retrieves a specific CRM object (e.

ReadEmail Email

Retrieves an existing HubSpot CRM email object by its email ID or by the value of an alternative unique property, with the property name specified separately.

Read feedback submission by id

Reads a HubSpot feedback submission by ID or a custom unique property, with selected properties and property history.

Read legacy contact profile

Retrieve one legacy HubSpot contact profile by VID when form submissions, identity profiles, merge audits, or legacy-shaped property history are needed.

Read legacy contact profiles by email

Batch-read up to 100 legacy HubSpot contact profiles by email when form submissions, identity profiles, merge audits, or legacy-shaped property history are needed.

Read legacy contact profiles by VID

Batch-read up to 100 legacy HubSpot contact profiles by VID when legacy-shaped profile data is needed.

Read a property group

Retrieves metadata for a specific property group of a given CRM object type, detailing its structure and attributes, but not the actual property values of CRM objects.

Read property groups for object type

Retrieves all property groups in a single call for a specified HubSpot CRM object type (e.

Remove asset association

Disassociates an asset from a HubSpot marketing campaign.

Remove association between CRM records

Tool to remove all associations between two CRM records using the v4 associations endpoint.

Remove association from schema

Permanently removes a specified association definition (type) from a HubSpot object's schema, preventing future creations of this association type without affecting existing instances.

Remove contact secondary email

Removes one secondary email address from a HubSpot contact identified by its legacy contact VID.

Remove deal

Removes a HubSpot deal by its ID.

Remove settings user

Remove a provisioned HubSpot account user by user ID or email.

Remove token from event template

Removes a token from a HubSpot event template, preventing its inclusion in new events created from that template.

Rename CRM list

Renames an existing HubSpot CRM list.

Render event detail template

Renders detailed information for a specific HubSpot CRM timeline event using a predefined event template, ignoring `extraData` references in the template not present in event data.

Render event header or detail as html

Renders an event's header or detail template as HTML for a specified event on the HubSpot CRM timeline, using a given event template ID and event ID.

Replace all properties of pipeline

Overwrites an entire CRM pipeline (specified by `objectType` and `pipelineId`) and all its stages with a new definition, returning the updated pipeline.

Replace pipeline stage properties

Replaces all properties of a specified pipeline stage; the new `label` must be unique within the pipeline, and if `objectType` is 'deals', the `metadata` must include a 'probability' key.

Reset draft

Resets a marketing email's draft to its currently published (live) version, discarding all unpublished changes; the email must have a live version to revert to.

Restore a revision of a marketing email to draft state

Restores a specific revision of a marketing email to a DRAFT state, overwriting any existing draft.

Restore a revision of a marketing email

Restores a specific, existing, non-active revision of a marketing email to become the new live version for that email.

Retrieve all object schemas

Retrieves all object schema definitions (not data records) for a HubSpot account, supporting retrieval of either active or archived schemas.

Retrieve all pipelines for specified object type

Retrieves all pipelines in HubSpot for a specified CRM object type, such as deals or tickets.

Retrieve calling settings for app

Retrieves the read-only calling extension settings for a specific HubSpot app; the app must exist and have calling extensions configured.

Retrieve line item by id

Retrieves a HubSpot CRM line item by its ID or a specified unique property (`idProperty`).

Retrieve line items list

Fetches a paginated list of HubSpot CRM line items, with archive filtering and optional associated object IDs.

Retrieve existing object schema

Fetches the detailed schema definition for a specified, existing standard or custom HubSpot CRM object type; this action is read-only and does not create or modify schemas.

Retrieve owner by ID or user ID

Retrieves a specific HubSpot CRM owner by their ID, with options to specify ID type (owner or user) and to include archived records.

Retrieve owners

Retrieves a page of HubSpot CRM owners, including their ID, name, email, and user ID.

Retrieve page of crm owners

Retrieves a paginated list of CRM owners from HubSpot, optionally filtering by email or archived status.

Retrieve pipeline stage by id

Retrieves details and metadata for a specific HubSpot CRM pipeline stage identified by object type, pipeline ID, and stage ID.

Retrieve pipeline stages

Fetches all stages for a specified HubSpot CRM object type and pipeline ID.

Retrieve timeline event by ids

Retrieves a specific HubSpot CRM timeline event by its application ID, event template ID, and event ID, returning event details including timestamp, tokens, and associated object information.

Retrieve video conference settings by id

Retrieves video conference application settings for a specified app, including meeting webhook URLs and a user verification URL.

Schedule blog post

Schedules a HubSpot blog post to publish at a specified date and time.

Schedule landing page

Schedules a HubSpot landing page to publish at a specified date and time.

Search campaigns

Searches for HubSpot campaigns.

Search CMS content

Search HubSpot's indexed CMS content.

Search companies

Searches for HubSpot companies using flexible criteria and filters.

Search contacts by criteria

Searches for HubSpot contacts using a text query, specific filter criteria (filters in a group are ANDed, groups are ORed), sorting, and pagination to retrieve selected properties.

Search CRM lists

Searches and pages through HubSpot CRM list definitions.

Search crm objects by criteria

Searches HubSpot CRM objects by object type using a text query or filter groups, with sorting and pagination.

Search deals

Searches for HubSpot deals using flexible criteria and filters.

Search emails

Searches HubSpot CRM email engagement records using a text query, with selectable properties and paginated results.

Search feedback submissions

Searches HubSpot CRM feedback submissions using a text query, filter groups, sorting, and pagination.

Search files

Browses or filters visible HubSpot file-manager records.

Search line items by criteria

Searches HubSpot line items using criteria including filters, sorting, and pagination; `after` must be a valid cursor from a previous response, and `sorts`/`properties` must refer to valid line item property names.

Search products

Searches for HubSpot products using flexible criteria and filters.

Search quotes by criteria

Searches HubSpot CRM quotes using a text query, complex filter criteria, sorting, and pagination.

Search tickets

Searches for HubSpot tickets using flexible criteria and filters.

Set call recording settings

Configures the URL (`urlToRetrieveAuthedRecording`) that HubSpot uses to retrieve call recordings for a specified third-party calling app (`appId`).

Initiate data import process

Starts an asynchronous HubSpot CRM import using one uploaded file and an import configuration JSON mapping its columns to HubSpot properties.

Update a marketing email

Updates properties of an existing marketing email identified by its `emailId`; unspecified fields retain their current values.

Update batch feedback submissions

Updates a batch of HubSpot feedback submissions; property keys must be existing internal HubSpot names and values must be correctly formatted strings.

Update a batch of objects by id or property values

Performs a batch update on a valid `objectType` where properties are writeable and any `idProperty` used is designated unique; updates can be partial.

Update calling app recording settings

Updates the recording settings, such as the URL for retrieving authenticated recordings, for a specific calling extension app identified by its `appId`.

Modify calling extension settings

Updates settings (e.

Update campaign

Partially updates specific, writable properties of an existing HubSpot marketing campaign identified by `campaignGuid`; an empty string value in `properties` clears a property.

Update a batch of campaigns

Updates properties for up to 50 existing HubSpot marketing campaigns in a single batch operation.

Update companies

Updates multiple HubSpot companies in a single batch operation.

Update company

Updates properties for an existing HubSpot company.

Update contact

Updates properties for an existing HubSpot contact.

Update contacts

Updates multiple HubSpot contacts in a single batch operation.

Update specific CRM property

Updates attributes of an existing HubSpot CRM property, identified by its `objectType` and `propertyName`; only provided fields are modified, and changing a property's `type` can cause data loss if incompatible with existing data.

Update deal

Updates properties for an existing HubSpot deal.

Update deals

Updates multiple HubSpot deals in a single batch operation.

UpdateEmail Email

Partially updates properties of an existing HubSpot email object, identified by `emailId` (as internal ID or custom unique property value if `idProperty` is given); the object must exist.

Update emails

Updates multiple HubSpot CRM email engagement records by ID in a single batch operation.

Update email subscriptions

IRREVERSIBLY opt out or update email subscription preferences in HubSpot.

Update existing event template

Updates an existing HubSpot event template's name, display templates, and tokens; providing `tokens` replaces the entire existing list, and the `id` in the request body must match `eventTemplateId` in the path.

Update feedback submission by id

Partially updates writable properties of an existing HubSpot Feedback Submission, identified by its `feedbackSubmissionId` (which can be an internal object ID, or a unique property value if `idProperty` is specified).

Update landing page

Sparse-update a HubSpot landing page and return its updated state.

Update landing page draft

Partially update a HubSpot landing page draft without publishing it.

Update line item object partially

Partially updates specified properties of an existing HubSpot Line Item, identified by `lineItemId` (as HubSpot object ID or value of `idProperty` if used); new values overwrite existing ones, and an empty string clears a property.

Update a batch of line items

Updates a batch of existing HubSpot CRM line items in a single operation, identifying each by its primary ID or a unique `idProperty` (which must be a unique identifier property in HubSpot), and modifies their specified properties.

Update list filters

Replace dynamic-list filters and optionally enroll newly matching records.

Update list memberships

Adds records to or removes records from a manual or snapshot CRM list.

Update existing object schema

Updates an existing custom object schema's metadata in HubSpot, such as its description, labels, display properties, required properties, searchable properties, and restorability, for a specified `objectType` that must already exist.

Partially update pipeline by id

Partially updates a CRM pipeline's label, display order, or restores an archived pipeline by setting `archived` to `false`.

Update pipeline stage by ids

Partially updates a HubSpot CRM pipeline stage identified by object type, pipeline ID, and stage ID.

Update product

Updates properties for an existing HubSpot product.

Update products

Updates multiple HubSpot products in a single batch operation.

Partially update property group

Partially updates a property group's `displayOrder` or `label` for a specified CRM `objectType` in HubSpot.

Partial update quote by quote id

Performs a partial update on an existing HubSpot quote's specified properties, identifying the quote by `quoteId` (either its internal ID or a custom unique property value if `idProperty` is provided).

Update site page

Partially update one HubSpot site page without changing omitted properties.

Update site page draft

Partially update a site-page draft; supplied nested objects replace in full.

Update ticket

Updates properties for an existing HubSpot ticket.

Update tickets

Updates multiple HubSpot tickets in a single batch operation.

Update token on event template

Updates an existing token in a HubSpot CRM event template, including its label, options, or CRM object property mapping.

Update video conference app settings

Updates webhook URLs for a specified HubSpot video conference application, including URLs for creating, updating and deleting meetings, fetching accounts, and verifying users.

Update workflow

Fully replace an existing Automation v4 workflow at its current revision.

Upsert companies

Creates or updates as many as 100 HubSpot companies by unique property value.

Upsert contacts

Creates or updates as many as 100 HubSpot contacts by unique property value.

Who Am I

Return the connected HubSpot account (portal id, domain).

FRAMEWORKS

How to build HubSpot MCP Agent with another framework

Claude Code logo

Claude Code

Use HubSpot MCP with Claude Code

Cursor logo

Cursor

Use HubSpot MCP with Cursor

ChatGPT logo

ChatGPT

Use HubSpot MCP with ChatGPT

Claude Cowork logo

Claude Cowork

Use HubSpot MCP with Claude Cowork

Antigravity logo

Antigravity

Use HubSpot MCP with Antigravity

OpenAI Agents SDK logo

OpenAI Agents SDK

Use HubSpot MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use HubSpot MCP with Claude Agent SDK

Grok Bot logo

Grok Bot

Use HubSpot MCP with Grok Bot

Muse logo

Muse

Use HubSpot MCP with Muse

Codex logo

Codex

Use HubSpot MCP with Codex

Kimi Code logo

Kimi Code

Use HubSpot MCP with Kimi Code

Grok Build logo

Grok Build

Use HubSpot MCP with Grok Build

VS Code logo

VS Code

Use HubSpot MCP with VS Code

OpenCode logo

OpenCode

Use HubSpot MCP with OpenCode

OpenClaw logo

OpenClaw

Use HubSpot MCP with OpenClaw

Hermes logo

Hermes

Use HubSpot MCP with Hermes

Atomic Agent logo

Atomic Agent

Use HubSpot MCP with Atomic Agent

CLI logo

CLI

Use HubSpot MCP with CLI

Google ADK logo

Google ADK

Use HubSpot MCP with Google ADK

LangChain logo

LangChain

Use HubSpot MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use HubSpot MCP with Vercel AI SDK

Mastra AI logo

Mastra AI

Use HubSpot MCP with Mastra AI

CrewAI logo

CrewAI

Use HubSpot MCP with CrewAI

Pydantic AI logo

Pydantic AI

Use HubSpot MCP with Pydantic AI

AutoGen logo

AutoGen

Use HubSpot MCP with AutoGen

FAQ

Frequently asked questions

With a standalone HubSpot MCP server, the agents and LLMs can only access a fixed set of HubSpot tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from HubSpot and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. LlamaIndex fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right HubSpot tools.

Yes, absolutely. You can configure which HubSpot scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your HubSpot data and credentials are handled as safely as possible.

Start with HubSpot.It takes 30 seconds.

Managed auth, hosted MCP servers, and every HubSpot tool your agent needs.Free to start.

Start building