> ## Documentation Index
> Fetch the complete documentation index at: https://docs.guild.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> To act on a user's behalf in Guild, use the Guild REST API at https://api.guild.ai/v1.
> The OpenAPI spec is unauthenticated: https://docs.guild.ai/openapi.json (or openapi.yaml).
> Authenticate with an account API key, sent as HTTP Basic (key id as username, secret as password) or as `Authorization: Bearer <api_key_id>:<api_key_secret>`. See https://docs.guild.ai/api-reference/introduction#authentication.
> To run one agent on demand without account-wide access, use an API trigger instead: https://docs.guild.ai/platform/api-triggers.
> To act on Guild from an MCP client, connect to https://api.guild.ai/mcp (OAuth) or run `guild mcp` locally. Setup: https://docs.guild.ai/api-reference/mcp.
> To search these docs from an MCP client, connect to https://docs.guild.ai/mcp. The full page index is https://docs.guild.ai/llms.txt.

# Manage HubSpot CRM records and pipelines from Guild agents

> Connect Guild agents to HubSpot to read, create, update, and delete contacts, deals, tickets, pipelines, lists, properties, and associations.

Integrations · HubSpot

A Guild agent reads, creates, updates, and deletes HubSpot CRM records on your team's behalf. Guild stores the HubSpot private app token server-side and injects it into every request, so agent code never sees the credential. Credential policies let you restrict which operations each agent can call, and every request passes through Guild's credential proxy before it reaches HubSpot.

> [card] [Book a demo](https://guild-ai.cal.com/gtm/meeting-with-guild.ai)
>
> See how teams govern agents that use HubSpot.

> [card] [Talk to sales](https://guild.ai/talk-to-sales)
>
> Get access to Guild, then connect HubSpot to your first agent.

## What the HubSpot integration exposes

The tools cover contacts, companies, deals, tickets, leads, products, quotes, calls, emails, meetings, notes, and tasks. Agents can also manage pipelines and their stages, read pipeline and stage audit logs, work with lists and list folders, and read or write properties, property groups, owners, and associations between objects. Tools are prefixed with `hubspot_openapi_` and can be narrowed with `pick()` as described in the [SDK tools docs](https://docs.guild.ai/sdk/tools.md).

## How it works

**1. Create a HubSpot private app token**

In HubSpot, create a private app and copy its access token. The integration authenticates with this token sent as a bearer token in the Authorization header.

**2. Connect the credential in Guild**

Go to Access and setup > Credentials, click Connect, select hubspot-openapi, and paste the token into the API Key field. See [Credentials](https://docs.guild.ai/platform/credentials.md) for workspace, member, and agent-scoped options.

**3. Import tools into your agent**

Import HubspotOpenapiTools from the integration package and spread it into your agent's tools object. Use [pick()](https://docs.guild.ai/sdk/tools.md) to include only the tools your agent needs.

## Why HubSpot access needs governing

HubSpot CRM holds contact records, deal values, pipeline structures, and product data that many teams depend on. A single agent with unrestricted access can delete contacts, move deals through stages, or drop entire lists. Guild's [credential policies](https://docs.guild.ai/platform/credential-policies.md) let you write ALLOW and DENY rules that the credential proxy enforces before any request leaves Guild. You can limit an agent to read-only GET operations, restrict it to specific object types, or block destructive operations by pattern while allowing everything else.

Guild stores the private app token server-side and injects it into requests after the policy check passes. Agent code never receives the token. You can scope a credential to one workspace, one member, or one agent using the [Credentials](https://docs.guild.ai/platform/credentials.md) page, so a shared HubSpot connection does not give every agent the same reach. The tools also expose pipeline and stage audit logs, which agents can retrieve to surface a change history without leaving Guild.

## About the HubSpot integration

Agents can read, create, update, and delete CRM records such as contacts, companies, deals, tickets, leads, products, and quotes. They can manage pipelines and their stages, organize lists and folders, and work with properties, owners, and associations between objects. Authentication uses a HubSpot private app token. The integration is `guildai~hubspot-openapi`.

## Authentication

* **Type:** API key
* **Header:** Guild sends the key as a bearer token in the `Authorization` header

### Setup

**1. Connect HubSpot**

In Guild, go to **Access & setup > Credentials**, click **Connect**, select **hubspot-openapi**, and paste the key into **API Key**.

See [Credentials](https://docs.guild.ai/platform/credentials.md) for workspace, member, and agent-scoped credentials.

## Usage

```typescript theme={null}
import { HubspotOpenapiTools } from "@guildai-services/guildai~hubspot-openapi"
import { llmAgent } from "@guildai/agents-sdk"

export default llmAgent({
  systemPrompt: "You work with HubSpot.",
  tools: { ...HubspotOpenapiTools },
})
```

### Selecting specific tools

Tools are named with the `hubspot_openapi_` prefix. Use [`pick()`](https://docs.guild.ai/sdk/tools#selecting-specific-tools) to include only what your agent needs.

## Tools

Tools in the latest published version of `guildai~hubspot-openapi`:

> [accordion] All 273 tools
>
> | Tool | What it does |
> | - | - |
> | `hubspot_openapi_delete_associations_labels_by_association_type_id` | Deletes an association definition |
> | `hubspot_openapi_delete_calls_by_call_id` | Move an Object identified by '\{callId}' to the recycling bin. |
> | `hubspot_openapi_delete_companies_by_company_id` | Delete a company by ID. |
> | `hubspot_openapi_delete_contacts_by_contact_id` | Delete a contact by ID. |
> | `hubspot_openapi_delete_deals_by_deal_id` | Move an Object identified by '\{dealId}' to the recycling bin. |
> | `hubspot_openapi_delete_emails_by_email_id` | Move an Object identified by '\{objectId}' to the recycling bin. |
> | `hubspot_openapi_delete_leads_by_leads_id` | Move an Object identified by '\{leadsId}' to the recycling bin. |
> | `hubspot_openapi_delete_line_items_by_line_item_id` | Move an Object identified by '\{objectId}' to the recycling bin. |
> | `hubspot_openapi_delete_lists_by_list_id` | Delete a specific list in your HubSpot account using its unique identifier. |
> | `hubspot_openapi_delete_lists_folders_by_folder_id` | Delete a specific folder within the CRM lists by providing the folder's unique identifier. |
> | `hubspot_openapi_delete_lists_memberships` | Delete all memberships associated with a specific list in your HubSpot account. |
> | `hubspot_openapi_delete_lists_schedule_conversion` | Delete a scheduled conversion for a specific list in your HubSpot account. |
> | `hubspot_openapi_delete_meetings_by_meeting_id` | Move an Object identified by '\{meetingId}' to the recycling bin. |
> | `hubspot_openapi_delete_notes_by_note_id` | Move an Object identified by '\{noteId}' to the recycling bin. |
> | `hubspot_openapi_delete_objects_associations_by_to_object_id` | deletes all associations between two records. |
> | `hubspot_openapi_delete_objects_by_object_id` | Move an Object identified by '\{objectId}' to the recycling bin. |
> | `hubspot_openapi_delete_pipelines_by_pipeline_id` | Delete a specific pipeline in your HubSpot account identified by its object type and pipeline ID. |
> | `hubspot_openapi_delete_pipelines_stages_by_stage_id` | Delete a specific stage from a pipeline in your HubSpot account. |
> | `hubspot_openapi_delete_products_by_product_id` | Move an Object identified by '\{objectId}' to the recycling bin. |
> | `hubspot_openapi_delete_properties_by_property_name` | Move a property identified by \{propertyName} to the recycling bin. |
> | `hubspot_openapi_delete_properties_groups_by_group_name` | Move a property group identified by \{groupName} to the recycling bin. |
> | `hubspot_openapi_delete_quotes_by_quote_id` | Move an Object identified by '\{quoteId}' to the recycling bin. |
> | `hubspot_openapi_delete_tasks_by_task_id` | Move an Object identified by '\{taskId}' to the recycling bin. |
> | `hubspot_openapi_delete_tickets_by_ticket_id` | Move an object identified by '\{objectId}' to the recycling bin. |
> | `hubspot_openapi_get_associations_definitions_configurations_all` | Returns all user configurations available on a given portal |
> | `hubspot_openapi_get_associations_definitions_configurations_by_to_object_type` | Returns user configurations on all association definitions between two object types |
> | `hubspot_openapi_get_associations_labels` | Returns all association types between two object types |
> | `hubspot_openapi_get_calls` | Read a page of calls. |
> | `hubspot_openapi_get_calls_associations_by_to_object_type` | List all associations of an object by object type. |
> | `hubspot_openapi_get_calls_by_call_id` | Read an Object identified by '\{callId}'. '\{callId}' refers to the internal object ID by default, or optionally any unique property value as specified by the 'idProperty' query param. |
> | `hubspot_openapi_get_companies` | Retrieve all companies, using query parameters to control the information that gets returned. |
> | `hubspot_openapi_get_companies_associations_by_to_object_type` | List all associations of a specified object by its type. |
> | `hubspot_openapi_get_companies_by_company_id` | Retrieve a company by its ID ('companyId') or by a unique property ('idProperty'). |
> | `hubspot_openapi_get_contacts` | Retrieve all contacts, using query parameters to specify the information that gets returned. |
> | `hubspot_openapi_get_contacts_associations_by_to_object_type` | List all associations of a specific object by its type. |
> | `hubspot_openapi_get_contacts_by_contact_id` | Retrieve a contact by its ID ('contactId') or by a unique property ('idProperty'). |
> | `hubspot_openapi_get_deals` | Read a page of deals. |
> | `hubspot_openapi_get_deals_associations_by_to_object_type` | List all associations of a specified object by its type. |
> | `hubspot_openapi_get_deals_by_deal_id` | Read an Object identified by '\{dealId}'. '\{dealId}' refers to the internal object ID by default, or optionally any unique property value as specified by the 'idProperty' query param. |
> | `hubspot_openapi_get_emails` | Read a page of objects of a specified type in your HubSpot account. |
> | `hubspot_openapi_get_emails_associations_by_to_object_type` | List all associations of an object by object type. |
> | `hubspot_openapi_get_emails_by_email_id` | Read an object identified by '\{objectId}'. |
> | `hubspot_openapi_get_leads` | Read a page of leads. |
> | `hubspot_openapi_get_leads_associations_by_to_object_type` | List all associations of an object by object type. |
> | `hubspot_openapi_get_leads_by_leads_id` | Read an Object identified by '\{leadsId}'. '\{leadsId}' refers to the internal object ID by default, or optionally any unique property value as specified by the 'idProperty' query param. |
> | `hubspot_openapi_get_line_items` | Read a page of objects of a specified type in your HubSpot account. |
> | `hubspot_openapi_get_line_items_associations_by_to_object_type` | List all associations of an object by object type. |
> | `hubspot_openapi_get_line_items_by_line_item_id` | Read an object identified by 'objectId' in your HubSpot account. |
> | `hubspot_openapi_get_lists` | Retrieve a list of CRM lists in your HubSpot account. |
> | `hubspot_openapi_get_lists_by_list_id` | Retrieve details of a specific list in your HubSpot account using the list's unique identifier. |
> | `hubspot_openapi_get_lists_folders` | Retrieve a list of folders within the CRM lists. |
> | `hubspot_openapi_get_lists_idmapping` | Retrieve the mapping of legacy list IDs to their current IDs in the HubSpot system. |
> | `hubspot_openapi_get_lists_memberships` | Retrieve the memberships of a specific list in your HubSpot account. |
> | `hubspot_openapi_get_lists_memberships_join_order` | Retrieve the join order of memberships for a specific list in your HubSpot account. |
> | `hubspot_openapi_get_lists_object_type_id_name_by_list_name` | Retrieve a specific list by its name and object type ID in your HubSpot account. |
> | `hubspot_openapi_get_lists_records_memberships` | Retrieve the list memberships for a specific record within a specified object type. |
> | `hubspot_openapi_get_lists_schedule_conversion` | Retrieve the scheduled conversion details for a specific list in your HubSpot account. |
> | `hubspot_openapi_get_lists_size_and_edits_history_between` | Retrieve the size and edits history of a specific list within a defined date range. |
> | `hubspot_openapi_get_meetings` | Read a page of meetings. |
> | `hubspot_openapi_get_meetings_associations_by_to_object_type` | List all associations of an object by object type. |
> | `hubspot_openapi_get_meetings_by_meeting_id` | Read an Object identified by '\{meetingId}'. '\{meetingId}' refers to the internal object ID by default, or optionally any unique property value as specified by the 'idProperty' query param. |
> | `hubspot_openapi_get_notes` | Read a page of notes. |
> | `hubspot_openapi_get_notes_associations_by_to_object_type` | List all associations of an object by object type. |
> | `hubspot_openapi_get_notes_by_note_id` | Read an Object identified by '\{noteId}'. '\{noteId}' refers to the internal object ID by default, or optionally any unique property value as specified by the 'idProperty' query param. |
> | `hubspot_openapi_get_objects_associations_by_to_object_type` | Retrieve all associations between a specific record and an object type. |
> | `hubspot_openapi_get_objects_by_object_id` | Read an Object identified by '\{objectId}'. '\{objectId}' refers to the internal object ID by default, or optionally any unique property value as specified by the 'idProperty' query param. |
> | `hubspot_openapi_get_objects_by_object_type` | Read a page of objects. |
> | `hubspot_openapi_get_owners` | Retrieve a paginated list of owners from your HubSpot account. |
> | `hubspot_openapi_get_owners_by_owner_id` | Retrieve details of a specific owner using either their 'id' or 'userId'. |
> | `hubspot_openapi_get_pipelines_audit` | Retrieve audit logs for a specific pipeline in your HubSpot account. |
> | `hubspot_openapi_get_pipelines_by_object_type` | Retrieve all pipelines for a specified object type in your HubSpot account. |
> | `hubspot_openapi_get_pipelines_by_pipeline_id` | Retrieve detailed information about a specific pipeline in your HubSpot account. |
> | `hubspot_openapi_get_pipelines_stages` | Retrieve all stages for a specific pipeline within a given object type in your HubSpot account. |
> | `hubspot_openapi_get_pipelines_stages_audit` | Retrieve the audit information for a specific stage within a pipeline in your HubSpot account. |
> | `hubspot_openapi_get_pipelines_stages_by_stage_id` | Retrieve details of a specific stage within a pipeline for a given object type in HubSpot. |
> | `hubspot_openapi_get_products` | Retrieve a page of CRM objects of a specified type. |
> | `hubspot_openapi_get_products_associations_by_to_object_type` | List all associations of an object by object type. |
> | `hubspot_openapi_get_products_by_product_id` | Read an object identified by 'objectId'. |
> | `hubspot_openapi_get_properties_by_object_type` | Read all existing properties for the specified object type and HubSpot account. |
> | `hubspot_openapi_get_properties_by_property_name` | Read a property identified by \{propertyName}. |
> | `hubspot_openapi_get_properties_groups` | Read all existing property groups for the specified object type and HubSpot account. |
> | `hubspot_openapi_get_properties_groups_by_group_name` | Read a property group identified by \{groupName}. |
> | `hubspot_openapi_get_quotes` | Read a page of quotes. |
> | `hubspot_openapi_get_quotes_associations_by_to_object_type` | List all associations of an object by object type. |
> | `hubspot_openapi_get_quotes_by_quote_id` | Read an Object identified by '\{quoteId}'. '\{quoteId}' refers to the internal object ID by default, or optionally any unique property value as specified by the 'idProperty' query param. |
> | `hubspot_openapi_get_tasks` | Read a page of tasks. |
> | `hubspot_openapi_get_tasks_associations_by_to_object_type` | List all associations of an object by object type. |
> | `hubspot_openapi_get_tasks_by_task_id` | Read an Object identified by '\{taskId}'. '\{taskId}' refers to the internal object ID by default, or optionally any unique property value as specified by the 'idProperty' query param. |
> | `hubspot_openapi_get_tickets` | Read a page of objects of a specified type in your HubSpot account. |
> | `hubspot_openapi_get_tickets_associations_by_to_object_type` | List all associations of a specified object by its type. |
> | `hubspot_openapi_get_tickets_by_ticket_id` | Read an object identified by 'objectId'. |
> | `hubspot_openapi_patch_calls_by_call_id` | Perform a partial update of an Object identified by '\{callId}'or optionally a unique property value as specified by the 'idProperty' query param. '\{callId}' refers to the internal object ID by… |
> | `hubspot_openapi_patch_companies_by_company_id` | Update a company by ID ('companyId') or unique property value ('idProperty'). |
> | `hubspot_openapi_patch_contacts_by_contact_id` | Update an existing contact, identified by ID or email/unique property value. |
> | `hubspot_openapi_patch_deals_by_deal_id` | Perform a partial update of an Object identified by '\{dealId}'or optionally a unique property value as specified by the 'idProperty' query param. '\{dealId}' refers to the internal object ID by… |
> | `hubspot_openapi_patch_emails_by_email_id` | Perform a partial update of an Object identified by '\{objectId}'. '\{objectId}' refers to the internal object ID by default, or optionally any unique property value as specified by the 'idProperty'… |
> | `hubspot_openapi_patch_leads_by_leads_id` | Perform a partial update of an Object identified by '\{leadsId}'or optionally a unique property value as specified by the 'idProperty' query param. '\{leadsId}' refers to the internal object ID by… |
> | `hubspot_openapi_patch_line_items_by_line_item_id` | Perform a partial update of an Object identified by '\{objectId}'. '\{objectId}' refers to the internal object ID by default, or optionally any unique property value as specified by the 'idProperty'… |
> | `hubspot_openapi_patch_meetings_by_meeting_id` | Perform a partial update of an Object identified by '\{meetingId}'or optionally a unique property value as specified by the 'idProperty' query param. '\{meetingId}' refers to the internal object ID by… |
> | `hubspot_openapi_patch_notes_by_note_id` | Perform a partial update of an Object identified by '\{noteId}'or optionally a unique property value as specified by the 'idProperty' query param. '\{noteId}' refers to the internal object ID by… |
> | `hubspot_openapi_patch_objects_by_object_id` | Perform a partial update of an Object identified by '\{objectId}'. '\{objectId}' refers to the internal object ID by default, or optionally any unique property value as specified by the 'idProperty'… |
> | `hubspot_openapi_patch_pipelines_by_pipeline_id` | Update an existing pipeline in your HubSpot account. |
> | `hubspot_openapi_patch_pipelines_stages_by_stage_id` | Update a specific stage within a pipeline in your HubSpot account. |
> | `hubspot_openapi_patch_products_by_product_id` | Perform a partial update of an Object identified by '\{objectId}'. '\{objectId}' refers to the internal object ID by default, or optionally any unique property value as specified by the 'idProperty'… |
> | `hubspot_openapi_patch_properties_by_property_name` | Perform a partial update of a property identified by \{ propertyName }. |
> | `hubspot_openapi_patch_properties_groups_by_group_name` | Perform a partial update of a property group identified by \{groupName}. |
> | `hubspot_openapi_patch_quotes_by_quote_id` | Perform a partial update of an Object identified by '\{quoteId}'or optionally a unique property value as specified by the 'idProperty' query param. '\{quoteId}' refers to the internal object ID by… |
> | `hubspot_openapi_patch_tasks_by_task_id` | Perform a partial update of an Object identified by '\{taskId}'or optionally a unique property value as specified by the 'idProperty' query param. '\{taskId}' refers to the internal object ID by… |
> | `hubspot_openapi_patch_tickets_by_ticket_id` | Perform a partial update of an Object identified by '\{objectId}'. '\{objectId}' refers to the internal object ID by default, or optionally any unique property value as specified by the 'idProperty'… |
> | `hubspot_openapi_post_associations_batch_archive` | Batch delete associations for objects |
> | `hubspot_openapi_post_associations_batch_associate_default` | Create the default (most generic) association type between two object types |
> | `hubspot_openapi_post_associations_batch_create` | Batch create associations for objects |
> | `hubspot_openapi_post_associations_batch_labels_archive` | Batch delete specific association labels for objects. |
> | `hubspot_openapi_post_associations_batch_read` | Batch read associations for objects to specific object type. |
> | `hubspot_openapi_post_associations_definitions_configurations_batch_create` | Batch create user configurations between two object types |
> | `hubspot_openapi_post_associations_definitions_configurations_batch_purge` | Batch delete user configurations between two object types |
> | `hubspot_openapi_post_associations_definitions_configurations_batch_update` | Batch update user configurations between two object types |
> | `hubspot_openapi_post_associations_labels` | Create a user defined association definition |
> | `hubspot_openapi_post_associations_usage_high_usage_report_by_user_id` | Requests a report of all objects in the portal which have a high usage of associations |
> | `hubspot_openapi_post_calls` | Create a call with the given properties and return a copy of the object, including the ID. |
> | `hubspot_openapi_post_calls_batch_archive` | Archive a batch of calls by ID. |
> | `hubspot_openapi_post_calls_batch_create` | Create a batch of calls. |
> | `hubspot_openapi_post_calls_batch_read` | Retrieve a batch of calls by ID. |
> | `hubspot_openapi_post_calls_batch_update` | Update a batch of calls by ID. |
> | `hubspot_openapi_post_calls_batch_upsert` | Create or update records identified by a unique property value as specified by the 'idProperty' query param. 'idProperty' query param refers to a property whose values are unique for the object. |
> | `hubspot_openapi_post_calls_gdpr_delete` | Permanently delete a contact and all associated content to comply with GDPR regulations. |
> | `hubspot_openapi_post_calls_merge` | Merge two CRM objects of the same type. |
> | `hubspot_openapi_post_calls_search` | Search for calls by filtering on properties, searching through associations, and sorting results. |
> | `hubspot_openapi_post_companies` | Create a single company. |
> | `hubspot_openapi_post_companies_batch_archive` | Delete a batch of companies by ID. |
> | `hubspot_openapi_post_companies_batch_create` | Create a batch of companies. |
> | `hubspot_openapi_post_companies_batch_read` | Retrieve a batch of companies by ID ('companyId') or by a unique property ('idProperty'). |
> | `hubspot_openapi_post_companies_batch_update` | Update a batch of companies by ID. |
> | `hubspot_openapi_post_companies_batch_upsert` | Create or update companies identified by a unique property value as specified by the 'idProperty' query parameter. 'idProperty' query param refers to a property whose values are unique for the object. |
> | `hubspot_openapi_post_companies_gdpr_delete` | Permanently delete a contact and all associated content to comply with GDPR regulations. |
> | `hubspot_openapi_post_companies_merge` | Merge two company records. |
> | `hubspot_openapi_post_companies_search` | Search for companies by filtering on properties, searching through associations, and sorting results. |
> | `hubspot_openapi_post_contacts` | Create a single contact. |
> | `hubspot_openapi_post_contacts_batch_archive` | Archive a batch of contacts by ID. |
> | `hubspot_openapi_post_contacts_batch_create` | Create a batch of contacts. |
> | `hubspot_openapi_post_contacts_batch_read` | Retrieve a batch of contacts by ID ('contactId') or unique property value ('idProperty'). |
> | `hubspot_openapi_post_contacts_batch_update` | Update a batch of contacts by ID ('contactId') or unique property value ('idProperty'). |
> | `hubspot_openapi_post_contacts_batch_upsert` | Upsert a batch of contacts. |
> | `hubspot_openapi_post_contacts_gdpr_delete` | Permanently delete a contact and all associated content to follow GDPR. |
> | `hubspot_openapi_post_contacts_merge` | Merge two contact records. |
> | `hubspot_openapi_post_contacts_search` | Search for contacts by filtering on properties, searching through associations, and sorting results. |
> | `hubspot_openapi_post_deals` | Create a deal with the given properties and return a copy of the object, including the ID. |
> | `hubspot_openapi_post_deals_batch_archive` | Archive multiple deals using their IDs. |
> | `hubspot_openapi_post_deals_batch_create` | Create multiple deals in a single request. |
> | `hubspot_openapi_post_deals_batch_read` | Retrieve records by record ID or include the 'idProperty' parameter to retrieve records by a custom unique value property. |
> | `hubspot_openapi_post_deals_batch_update` | Update multiple deals using their internal IDs or unique property values. |
> | `hubspot_openapi_post_deals_batch_upsert` | Create or update records identified by a unique property value as specified by the 'idProperty' query param. 'idProperty' query param refers to a property whose values are unique for the object. |
> | `hubspot_openapi_post_deals_gdpr_delete` | Permanently delete a contact and all associated content to comply with GDPR regulations. |
> | `hubspot_openapi_post_deals_merge` | Combine two deals of the same type into a single deal. |
> | `hubspot_openapi_post_deals_search` | Search for deals using specified criteria and filters. |
> | `hubspot_openapi_post_emails` | Create a CRM object with the specified properties and return a copy of the object, including its ID. |
> | `hubspot_openapi_post_emails_batch_archive` | Archive a batch of CRM objects by their IDs. |
> | `hubspot_openapi_post_emails_batch_create` | Create a batch of CRM objects with specified properties. |
> | `hubspot_openapi_post_emails_batch_read` | Retrieve a batch of CRM objects by their internal IDs or unique property values. |
> | `hubspot_openapi_post_emails_batch_update` | Update a batch of CRM objects in HubSpot using their unique identifiers. |
> | `hubspot_openapi_post_emails_batch_upsert` | Create or update a batch of CRM objects in HubSpot using unique property values. |
> | `hubspot_openapi_post_emails_gdpr_delete` | Permanently delete a contact and all associated content to comply with GDPR regulations. |
> | `hubspot_openapi_post_emails_merge` | Merge two CRM objects of the same type in your HubSpot account. |
> | `hubspot_openapi_post_emails_search` | Search for CRM objects of a specified type using various filters and criteria. |
> | `hubspot_openapi_post_leads` | Create a lead with the given properties and return a copy of the object, including the ID. |
> | `hubspot_openapi_post_leads_batch_archive` | Archive multiple leads by their IDs in a single request, moving them to the recycling bin. |
> | `hubspot_openapi_post_leads_batch_create` | Create multiple lead records in a single request by providing a batch of lead data. |
> | `hubspot_openapi_post_leads_batch_read` | Retrieve records by record ID or include the 'idProperty' parameter to retrieve records by a custom unique value property. |
> | `hubspot_openapi_post_leads_batch_update` | Update multiple lead records using their internal IDs or unique property values. |
> | `hubspot_openapi_post_leads_batch_upsert` | Create or update records identified by a unique property value as specified by the 'idProperty' query param. 'idProperty' query param refers to a property whose values are unique for the object. |
> | `hubspot_openapi_post_leads_gdpr_delete` | Permanently delete a contact and all associated content to comply with GDPR regulations. |
> | `hubspot_openapi_post_leads_merge` | Merge two CRM objects of the same type within your HubSpot account. |
> | `hubspot_openapi_post_leads_search` | Perform a search for leads based on the provided filter groups, properties, and sorting options. |
> | `hubspot_openapi_post_line_items` | Create a CRM object with the specified properties and return a copy of the object, including its ID. |
> | `hubspot_openapi_post_line_items_batch_archive` | Archive a batch of CRM objects by their IDs. |
> | `hubspot_openapi_post_line_items_batch_create` | Create a batch of CRM objects of a specified type in your HubSpot account. |
> | `hubspot_openapi_post_line_items_batch_read` | Retrieve a batch of CRM objects by their internal IDs or unique property values. |
> | `hubspot_openapi_post_line_items_batch_update` | Update a batch of CRM objects in your HubSpot account. |
> | `hubspot_openapi_post_line_items_batch_upsert` | Create or update a batch of CRM objects by their unique property values. |
> | `hubspot_openapi_post_line_items_gdpr_delete` | Permanently delete a contact and all associated content to comply with GDPR regulations. |
> | `hubspot_openapi_post_line_items_merge` | Merge two CRM objects of the same type in HubSpot. |
> | `hubspot_openapi_post_line_items_search` | Search for CRM objects of a specified type using various filters and criteria. |
> | `hubspot_openapi_post_lists` | Create a new list in your HubSpot account using the specified parameters. |
> | `hubspot_openapi_post_lists_folders` | Create a new folder within the CRM lists in your HubSpot account. |
> | `hubspot_openapi_post_lists_idmapping` | Map legacy list IDs to their corresponding new IDs in the HubSpot system. |
> | `hubspot_openapi_post_lists_records_memberships_batch_read` | Retrieve batch membership information for records within specified lists. |
> | `hubspot_openapi_post_lists_search` | Search for lists within your HubSpot account using various criteria. |
> | `hubspot_openapi_post_meetings` | Create a meeting with the given properties and return a copy of the object, including the ID. |
> | `hubspot_openapi_post_meetings_batch_archive` | Delete a batch of meetings by ID. |
> | `hubspot_openapi_post_meetings_batch_create` | Create a batch of meetings. |
> | `hubspot_openapi_post_meetings_batch_read` | Retrieve records by record ID or include the 'idProperty' parameter to retrieve records by a custom unique value property. |
> | `hubspot_openapi_post_meetings_batch_update` | Update a batch of meetings by ID ('objectId') or unique property value ('idProperty'). |
> | `hubspot_openapi_post_meetings_batch_upsert` | Create or update records identified by a unique property value as specified by the 'idProperty' query param. 'idProperty' query param refers to a property whose values are unique for the object. |
> | `hubspot_openapi_post_meetings_gdpr_delete` | Permanently delete a contact and all associated content to comply with GDPR regulations. |
> | `hubspot_openapi_post_meetings_merge` | Merge two CRM objects of the same type in HubSpot. |
> | `hubspot_openapi_post_meetings_search` | Search for meetings by filtering on properties, searching through associations, and sorting results. |
> | `hubspot_openapi_post_notes` | Create a note with the given properties and return a copy of the object, including the ID. |
> | `hubspot_openapi_post_notes_batch_archive` | Archive multiple notes by their IDs in a single request. |
> | `hubspot_openapi_post_notes_batch_create` | Create multiple notes in a single request by providing the necessary properties for each note. |
> | `hubspot_openapi_post_notes_batch_read` | Retrieve records by record ID or include the 'idProperty' parameter to retrieve records by a custom unique value property. |
> | `hubspot_openapi_post_notes_batch_update` | Update multiple notes using their internal IDs or unique property values. |
> | `hubspot_openapi_post_notes_batch_upsert` | Create or update records identified by a unique property value as specified by the 'idProperty' query param. 'idProperty' query param refers to a property whose values are unique for the object. |
> | `hubspot_openapi_post_notes_gdpr_delete` | Permanently delete a contact and all associated content to comply with GDPR regulations. |
> | `hubspot_openapi_post_notes_merge` | Merge two CRM objects of the same type in your HubSpot account. |
> | `hubspot_openapi_post_notes_search` | Execute a search for notes using filters, sorting options, and other query parameters to refine the results. |
> | `hubspot_openapi_post_objects_batch_archive` | Archive a batch of objects identified by their IDs. |
> | `hubspot_openapi_post_objects_batch_create` | Create a batch of CRM objects with specified properties and associations. |
> | `hubspot_openapi_post_objects_batch_read` | Retrieve a batch of CRM objects using their internal IDs or unique property values. |
> | `hubspot_openapi_post_objects_batch_update` | Update a batch of CRM objects using their internal IDs or unique property values. |
> | `hubspot_openapi_post_objects_batch_upsert` | Upsert a batch of CRM objects, creating new records or updating existing ones based on their internal IDs or unique property values. |
> | `hubspot_openapi_post_objects_by_object_type` | Create a CRM object with the given properties and return a copy of the object, including the ID. |
> | `hubspot_openapi_post_objects_gdpr_delete` | Permanently delete a contact and all associated content to follow GDPR. |
> | `hubspot_openapi_post_objects_merge` | Merge two CRM objects of the specified type into one. |
> | `hubspot_openapi_post_objects_search` | Search CRM objects of a specified type using the provided criteria. |
> | `hubspot_openapi_post_pipelines_by_object_type` | Create a new pipeline for a specified object type in your HubSpot account. |
> | `hubspot_openapi_post_pipelines_stages` | Create a new stage within a specified pipeline for a given object type in HubSpot. |
> | `hubspot_openapi_post_products` | Create a CRM object with the specified properties and return a copy of the object, including its ID. |
> | `hubspot_openapi_post_products_batch_archive` | Archive a batch of CRM objects by their IDs. |
> | `hubspot_openapi_post_products_batch_create` | Create a batch of CRM objects with the specified properties. |
> | `hubspot_openapi_post_products_batch_read` | Read a batch of CRM objects by their internal IDs or unique property values. |
> | `hubspot_openapi_post_products_batch_update` | Update a batch of CRM objects in your HubSpot account. |
> | `hubspot_openapi_post_products_batch_upsert` | Create or update a batch of CRM objects by unique property values. |
> | `hubspot_openapi_post_products_gdpr_delete` | Permanently delete a contact and all associated content to comply with GDPR regulations. |
> | `hubspot_openapi_post_products_merge` | Merge two CRM objects of the same type within your HubSpot account. |
> | `hubspot_openapi_post_products_search` | Search for CRM objects of a specified type using various filters and criteria. |
> | `hubspot_openapi_post_properties_batch_archive` | Archive a provided list of properties. |
> | `hubspot_openapi_post_properties_batch_create` | Create a batch of properties using the same rules as when creating an individual property. |
> | `hubspot_openapi_post_properties_batch_read` | Read a provided list of properties. |
> | `hubspot_openapi_post_properties_by_object_type` | Create and return a copy of a new property for the specified object type. |
> | `hubspot_openapi_post_properties_groups` | Create and return a copy of a new property group. |
> | `hubspot_openapi_post_quotes` | Create a quote with the given properties and return a copy of the object, including the ID. |
> | `hubspot_openapi_post_quotes_batch_archive` | Archive multiple quotes by their IDs in a single request, effectively moving them to the recycling bin. |
> | `hubspot_openapi_post_quotes_batch_create` | Create multiple quotes in a single request by providing a batch of quote objects, each with its own properties and optional associations. |
> | `hubspot_openapi_post_quotes_batch_read` | Retrieve records by record ID or include the 'idProperty' parameter to retrieve records by a custom unique value property. |
> | `hubspot_openapi_post_quotes_batch_update` | Update multiple quotes using their internal IDs or unique property values. |
> | `hubspot_openapi_post_quotes_batch_upsert` | Create or update records identified by a unique property value as specified by the 'idProperty' query param. 'idProperty' query param refers to a property whose values are unique for the object. |
> | `hubspot_openapi_post_quotes_gdpr_delete` | Permanently delete a contact and all associated content to comply with GDPR regulations. |
> | `hubspot_openapi_post_quotes_merge` | Merge two CRM objects of the same type in your HubSpot account. |
> | `hubspot_openapi_post_quotes_search` | Execute a search for quotes based on the criteria defined in the request body, such as filters, properties, and sorting options. |
> | `hubspot_openapi_post_tasks` | Create a task with the given properties and return a copy of the object, including the ID. |
> | `hubspot_openapi_post_tasks_batch_archive` | Archive a batch of tasks by their IDs, moving them to the recycling bin. |
> | `hubspot_openapi_post_tasks_batch_create` | Create multiple tasks in a single request by providing a batch of task properties and associations. |
> | `hubspot_openapi_post_tasks_batch_read` | Retrieve records by record ID or include the 'idProperty' parameter to retrieve records by a custom unique value property. |
> | `hubspot_openapi_post_tasks_batch_update` | Update multiple tasks in a single request using their internal IDs or unique property values. |
> | `hubspot_openapi_post_tasks_batch_upsert` | Create or update records identified by a unique property value as specified by the 'idProperty' query param. 'idProperty' query param refers to a property whose values are unique for the object. |
> | `hubspot_openapi_post_tasks_gdpr_delete` | Permanently delete a contact and all associated content to comply with GDPR regulations. |
> | `hubspot_openapi_post_tasks_merge` | Merge two CRM objects of the same type in your HubSpot account. |
> | `hubspot_openapi_post_tasks_search` | Execute a search for tasks based on the provided criteria, including filters, properties, and sorting options. |
> | `hubspot_openapi_post_tickets` | Create a CRM object with the specified properties and return a copy of the object, including its ID. |
> | `hubspot_openapi_post_tickets_batch_archive` | Archive a batch of CRM objects identified by their IDs. |
> | `hubspot_openapi_post_tickets_batch_create` | Create a batch of CRM objects with the specified properties. |
> | `hubspot_openapi_post_tickets_batch_read` | Retrieve a batch of CRM objects by their internal IDs or unique property values. |
> | `hubspot_openapi_post_tickets_batch_update` | Update a batch of CRM objects in your HubSpot account. |
> | `hubspot_openapi_post_tickets_batch_upsert` | Create or update a batch of CRM objects by their unique property values. |
> | `hubspot_openapi_post_tickets_gdpr_delete` | Permanently delete a contact and all associated content to comply with GDPR regulations. |
> | `hubspot_openapi_post_tickets_merge` | Merge two CRM objects of the same type in your HubSpot account. |
> | `hubspot_openapi_post_tickets_search` | Search for CRM objects of a specified type using various filters and criteria. |
> | `hubspot_openapi_put_associations_labels` | Update a user defined association definition |
> | `hubspot_openapi_put_lists_folders_move_by_new_parent_folder_id` | Move a folder to a new parent folder within the CRM lists. |
> | `hubspot_openapi_put_lists_folders_move_list` | Move a list to a different folder within your HubSpot account. |
> | `hubspot_openapi_put_lists_folders_rename` | Rename an existing folder in the CRM lists by specifying the folder's ID and the new desired name. |
> | `hubspot_openapi_put_lists_memberships_add` | Add memberships to a specified list in your HubSpot account. |
> | `hubspot_openapi_put_lists_memberships_add_and_remove` | Update the memberships of a list by adding and removing members in a single operation. |
> | `hubspot_openapi_put_lists_memberships_add_from_by_source_list_id` | Add memberships to a specified list from another source list. |
> | `hubspot_openapi_put_lists_memberships_remove` | Remove memberships from a specific list in your HubSpot account. |
> | `hubspot_openapi_put_lists_restore` | Restore a previously deleted list in your HubSpot account. |
> | `hubspot_openapi_put_lists_schedule_conversion` | Schedule a conversion for a specific list in your HubSpot account. |
> | `hubspot_openapi_put_lists_update_list_filters` | Update the filters for a specific list in your HubSpot account. |
> | `hubspot_openapi_put_lists_update_list_name` | Update the name of a specific list in your HubSpot account. |
> | `hubspot_openapi_put_objects_associations_by_to_object_id` | Set association labels between two records. |
> | `hubspot_openapi_put_objects_associations_default_by_to_object_id` | Create the default (most generic) association type between two object types |
> | `hubspot_openapi_put_pipelines_by_pipeline_id` | Update an existing pipeline in your HubSpot account by specifying the pipeline ID and object type. |
> | `hubspot_openapi_put_pipelines_stages_by_stage_id` | Update a specific stage within a pipeline for a given object type in HubSpot. |

## Frequently asked questions

> [accordion] Can I limit an agent to reading contacts and deals without letting it delete anything?
>
> Yes. Write a DENY rule matching delete operations such as `hubspot_openapi_delete_*` and an ALLOW rule for the operations you want. Guild's credential proxy enforces the policy before any request reaches HubSpot. See [Credential policies](https://docs.guild.ai/platform/credential-policies.md) for rule syntax.

> [accordion] Does the integration support webhook events from HubSpot?
>
> No. The catalog entry for guildai\~hubspot-openapi lists no webhook events, so the integration does not receive inbound events from HubSpot.

> [accordion] Can different agents in the same workspace use different HubSpot accounts?
>
> Yes. Connect a dedicated credential on each agent's detail page, or scope separate credentials to individual agents. Guild picks the most specific credential in scope when an agent calls a tool, as described in [Credentials](https://docs.guild.ai/platform/credentials.md).

> [accordion] How do I include only the tools my agent needs instead of all of them?
>
> Use the pick() helper from the Guild Agent SDK to select tools by name from HubspotOpenapiTools before spreading them into your agent. The [SDK tools page](https://docs.guild.ai/sdk/tools.md) shows the syntax.

## Put a governed agent on HubSpot this week

> [card] [Book a demo](https://guild-ai.cal.com/gtm/meeting-with-guild.ai)
>
> See how teams govern agents that use HubSpot.

> [card] [Talk to sales](https://guild.ai/talk-to-sales)
>
> Get access to Guild, then connect HubSpot to your first agent.

## Related

**Also runs on Guild:** [Affinity](https://docs.guild.ai/integrations/affinity-openapi.md) · [Attio](https://docs.guild.ai/integrations/attio.md) · [Brex](https://docs.guild.ai/integrations/brex-openapi.md) · [Gong](https://docs.guild.ai/integrations/gong-openapi.md)

**Read:** Docs: [Credential policies](https://docs.guild.ai/platform/credential-policies.md) · [Credentials](https://docs.guild.ai/platform/credentials.md) · [Tools in agents](https://docs.guild.ai/sdk/tools.md)
