Skip to content

CRM

HubSpot
API integration

Ship CRM features without building the integration. Full HubSpot API access via Proxy, normalized data through Unified APIs, and 280+ MCP-ready tools for AI agents — all extensible to your exact use case.

Talk to us
HubSpot

Use Cases

Why integrate with HubSpot

Common scenarios for SaaS companies building HubSpot integrations for their customers.

01

Sync CRM contacts to power in-app experiences

SaaS products pull Contacts and Companies from HubSpot to enrich their own user profiles, enabling features like account-level analytics, lead scoring overlays, or personalized onboarding flows—without asking end users to manually import CSVs.

02

Push product signals into the sales pipeline

PLG and usage-based SaaS platforms write product activity data (feature adoption, usage thresholds, trial milestones) back to HubSpot as custom properties or Deal stage updates, so sales reps can act on buying signals inside the CRM they already live in.

03

Automate deal creation from billing events

Subscription management and billing tools create and progress Deals in HubSpot when contracts are signed, invoices paid, or payments fail—keeping RevOps dashboards accurate without manual data entry from sales reps.

04

Log external activities to the HubSpot timeline

Dialers, document signing tools, and meeting platforms push call logs, signed agreements, and session recordings into HubSpot as Notes or Tasks, giving reps a complete interaction history on every Contact and Deal.

05

Capture and route leads directly into HubSpot

Event platforms, chatbots, and form tools create Contacts in HubSpot the moment a lead is captured, associate them with Companies, and assign Owners—triggering the customer's existing HubSpot workflows for nurture and follow-up.

What You Can Build

Ship these features with Truto + HubSpot

Concrete product features your team can ship faster by leveraging Truto’s HubSpot integration instead of building from scratch.

01

Bi-directional contact and company sync

Keep your app's contact records and HubSpot Contacts/Companies in lockstep with two-way sync that handles creates, updates, and deletes across both systems.

02

Pipeline-aware deal progression engine

Automatically create Deals and move them through HubSpot pipeline stages based on real-time events in your product—like successful payments, contract signatures, or onboarding completion.

03

CRM-enriched user profiles

Pull Contact details, associated Company info, Deal history, and Owner assignments from HubSpot to display rich CRM context directly inside your application's UI.

04

Automated activity logger

Push calls, emails, meetings, or any product-generated event into HubSpot as Notes or Tasks tied to the right Contact and Deal, eliminating manual logging for sales reps.

05

Owner-based lead routing

Fetch HubSpot Owners via the API and use assignment rules to automatically route new leads or tasks to the correct sales rep when your app creates or updates a Contact.

06

Custom property writeback for product signals

Write usage metrics, health scores, or feature adoption data to custom HubSpot properties on Contacts or Companies, enabling customers to trigger native HubSpot Workflows from your product's data.

SuperAI

HubSpot AI agent tools

Comprehensive AI agent toolset with fine-grained control. Integrates with MCP clients like Cursor and Claude, or frameworks like LangChain.

list_all_hub_spot_contacts

List HubSpot contacts with control over which properties and associations are returned. Returns each contact with id, properties, createdAt, updatedAt, archived, associations, and leadid. Max 100 per page.

get_single_hub_spot_contact_by_id

Get a single HubSpot contact by id. Returns the contact object including id, properties, createdAt, updatedAt, archived, and associations. Required: id.

create_a_hub_spot_contact

Create a new contact in HubSpot with the given properties and optional associations. Returns: id, properties, createdAt, updatedAt, archived. Required: properties.

update_a_hub_spot_contact_by_id

Update a HubSpot contact by id with a partial set of property values. Provided values are overwritten; read-only and non-existent properties are ignored; pass an empty string to clear a property. Returns: id, properties, createdAt, updatedAt, archived. Required: id, properties.

delete_a_hub_spot_contact_by_id

Archive a HubSpot contact by moving it to the recycling bin. Returns an empty 204 response on success. Required: id.

hub_spot_contacts_merge

Merge two HubSpot contacts by specifying a primary contact and a secondary contact to merge into it. Returns the resulting merged contact object including id, properties, createdAt, and updatedAt. Required: primaryId, idToMerge.

hub_spot_contacts_batch_delete

Archive (delete) a batch of HubSpot contacts by their IDs in a single request. Returns an empty 204 response on success. Required: inputs.

list_all_hub_spot_companies

List HubSpot companies with control over which properties and associations are returned. Returns: id, properties, createdAt, updatedAt, archived, associations.

get_single_hub_spot_company_by_id

Get a single HubSpot company by id, or by a unique property value when idProperty is specified. Returns: id, properties, createdAt, updatedAt, archived, associations, status, message, errorType, correlationId, policyName, requestId. Required: id.

hub_spot_companies_search

Search HubSpot companies by filtering on properties, searching through associations, and sorting results. Returns: id, properties, createdAt, updatedAt, archived. Requires a search request body.

update_a_hub_spot_company_by_id

Update a HubSpot company by id with provided property values. Returns: id, properties, createdAt, updatedAt, archived, status, message, errorType, correlationId, policyName, requestId. Required: id. Read-only and non-existent properties cause errors; pass an empty string to clear a value.

create_a_hub_spot_company

Create a single HubSpot company with property values and optional associations to other CRM records. Returns: id, properties, createdAt, updatedAt, archived, status, message, errorType, correlationId, policyName, requestId. Required: properties.

delete_a_hub_spot_company_by_id

Delete a HubSpot company by id. Deleted companies can be restored within 90 days of deletion. Returns an empty 204 response on success. Required: id.

hub_spot_companies_merge

Merge two HubSpot company records by specifying a primary company and a second company to merge into it. Returns the resulting merged company object including id, properties, createdAt, and updatedAt. Required: primaryObjectId, objectIdToMerge.

hub_spot_companies_batch_delete

Archive (delete) a batch of HubSpot companies by ID. Returns an empty 204 response on success. Required: inputs (an array of company ID objects). Deleted companies can be restored within 90 days of deletion.

list_all_hub_spot_users

List HubSpot account users from the Settings v3 user provisioning API. Returns each user's id, email, firstName, lastName, roleId, superAdmin, primaryTeamId, secondaryTeamIds, createdAt, and updatedAt. No required parameters; pagination is handled automatically.

get_single_hub_spot_user_by_id

Get a single HubSpot user by id. The id refers to the user's ID by default. Returns: id, email. Required: id.

delete_a_hub_spot_user_by_id

Delete a HubSpot user by id. The id refers to the user's ID by default, or optionally the user's email address when idProperty is set to EMAIL. Returns an empty 204 response on success. Required: id.

update_a_hub_spot_user_by_id

Update a HubSpot user by id. The id defaults to the user's ID but can specify an email address when id_property is set to EMAIL. Returns: id, email. Required: id.

create_a_hub_spot_user

Create a new user in a HubSpot account, including role and team assignments. Returns the created user object including id, email, first name, last name, and role assignment. Required: email.

list_all_hub_spot_deals

List HubSpot deals, controlling which properties and associations are returned. Returns each deal with id, properties, createdAt, updatedAt, archived, and associations. Using propertiesWithHistory reduces the maximum number of objects returned per page.

get_single_hub_spot_deal_by_id

Get a single HubSpot deal by id, optionally using idProperty to identify the deal by a unique property instead of the internal ID. Returns the deal object including id, properties, createdAt, updatedAt, archived, and associations. Required: id.

create_a_hub_spot_deal

Create a new HubSpot deal with the given properties and optional associations. Returns the created deal object including id, properties, createdAt, updatedAt, and archived. Required: properties.

update_a_hub_spot_deal_by_id

Partially update a HubSpot deal by id, overwriting provided property values. Read-only and non-existent properties cause an error; pass an empty string to clear a value. Returns the updated deal including id, properties, createdAt, updatedAt, and archived. Required: id, properties.

delete_a_hub_spot_deal_by_id

Archive a HubSpot deal by id, moving it to the recycling bin. Returns an empty 204 response on success. Required: id.

list_all_hub_spot_owners

List HubSpot CRM owners, optionally filtered by email address. Returns: id, email, userId, archived, createdAt, updatedAt. Set archived to true to include only archived owners.

get_single_hub_spot_owner_by_id

Get a specific HubSpot CRM owner by their owner id or userId. Returns: id, userId, email, archived. Required: id.

list_all_hub_spot_notes

List HubSpot CRM notes. Returns each note with id, properties, createdAt, updatedAt, archived, and associations. Use the properties and associations query parameters to control which fields are returned.

get_single_hub_spot_note_by_id

Get a single HubSpot CRM note by id. Returns: id, properties, createdAt, updatedAt, archived, associations. Required: id.

create_a_hub_spot_note

Create a HubSpot CRM note with the given properties and optional associations to other CRM records. Returns: id, properties, createdAt, updatedAt, archived. Required: properties.

update_a_hub_spot_note_by_id

Update a HubSpot CRM note by id with new property values. Property values can be cleared by passing an empty string; read-only and non-existent properties will result in an error. Returns: id, properties, createdAt, updatedAt, archived. Required: id, properties.

hub_spot_notes_get_for_contact

Search for HubSpot CRM notes associated with a specific contact. Returns each note with id, properties, createdAt, updatedAt, and archived. Required: contact_id.

hub_spot_notes_get_for_deal

Search for HubSpot notes associated with a specific deal by deal ID. Returns an array of note objects including id, properties, createdAt, updatedAt, and associations. Required: deal_id.

delete_a_hub_spot_note_by_id

Archive a HubSpot note by moving it to the recycling bin. Returns an empty 204 response on success. Required: id.

list_all_hub_spot_tasks

List HubSpot CRM tasks, controlling which properties are returned in the response. Returns each task with id, properties, createdAt, updatedAt, archived, and associations.

get_single_hub_spot_task_by_id

Get a single HubSpot CRM task by id. The id refers to the internal object ID by default, or optionally a unique property value when idProperty is supplied. Returns: id, properties, createdAt, updatedAt, archived, associations. Required: id.

create_a_hub_spot_task

Create a task in HubSpot CRM with the given properties and optional associations. Returns the created task object including id, properties, createdAt, updatedAt, and archived. Required: properties.

update_a_hub_spot_task_by_id

Update a HubSpot CRM task by id with a partial set of property values. Returns: id, properties, createdAt, updatedAt, archived. Required: id. Read-only and non-existent properties will cause an error; clear a value by passing an empty string.

hub_spot_tasks_get_for_contact

Search HubSpot CRM tasks associated with a specific contact. Returns: id, properties, createdAt, updatedAt, archived. Required: contact_id.

list_all_hub_spot_calls

List a page of HubSpot CRM calls. Control which properties and associations are returned via query parameters. Returns: id, properties, createdAt, updatedAt, archived, associations.

get_single_hub_spot_call_by_id

Get a single HubSpot CRM call by its internal object id. Control which properties are returned via the properties query param. Returns: id, properties, createdAt, updatedAt, archived, associations. Required: id.

create_a_hub_spot_call

Create a HubSpot CRM call with the given properties and optional associations. Returns: id, properties, createdAt, updatedAt, archived. Required: properties.

update_a_hub_spot_call_by_id

Partially update a HubSpot CRM call identified by id. Provided property values are overwritten; read-only and non-existent properties cause errors; pass an empty string to clear a value. Returns: id, properties, createdAt, updatedAt, archived. Required: id.

hub_spot_calls_batch_read

Read a batch of HubSpot CRM calls by their internal object IDs in a single request. Returns: id, properties, createdAt, updatedAt, archived. Required: inputs.

hub_spot_calls_search

Search for HubSpot calls by filtering on properties, searching through associations, and sorting results. Returns matching call records including id, properties, createdAt, and updatedAt. Required: a search request body with filter groups and/or sorting criteria.

list_all_hub_spot_emails

Read a page of emails in HubSpot. Returns fields including id, createdAt, updatedAt, archived status, properties, propertiesWithHistory, and associations.

get_single_hub_spot_email_by_id

Get information about a specific email in HubSpot by id. Returns email properties, associations, and archived status as specified.

create_a_hub_spot_email

Create an email in HubSpot with given properties. Returns the created email's id, createdAt, updatedAt, archived status, properties, and propertiesWithHistory.

update_a_hub_spot_email_by_id

Update an email object identified by id in HubSpot. Provide properties to overwrite existing values. Read-only and non-existent properties will cause errors. Properties can be cleared by passing an empty string.

hub_spot_emails_batch_read

Retrieve a batch of email records by id or unique property values in HubSpot. Requires inputs array and idProperty if using custom unique property. Returns fields id, createdAt, updatedAt, archived, properties, and propertiesWithHistory.

list_all_hub_spot_meetings

List HubSpot meetings with control over which properties and associations are returned. Returns: id, properties, createdAt, updatedAt, archived, associations.

get_single_hub_spot_meeting_by_id

Get a single HubSpot meeting by id, with optional control over returned properties and associations. Returns: id, properties, createdAt, updatedAt, archived, associations. Required: id.

create_a_hub_spot_meeting

Create a new HubSpot meeting with the given properties and optional associations. Returns the created meeting including id, properties, createdAt, updatedAt, archived. Required: properties.

update_a_hub_spot_meeting_by_id

Partially update a HubSpot meeting by id, overwriting provided property values. Properties values can be cleared by passing an empty string. Returns: id, properties, createdAt, updatedAt, archived. Required: id, properties.

hub_spot_meetings_batch_read

Read a batch of HubSpot meetings by internal ID or unique property values. Returns: id, properties, createdAt, updatedAt, archived. Required: inputs.

list_all_hub_spot_associations

List all association labels between two HubSpot CRM object types. Returns each label's associationTypeId, name, label, category, and primary flag. Required: from_object_type, to_object_type.

create_a_hub_spot_association

Create an association between two HubSpot CRM records by setting association labels. Returns: from, to, labels. Required: from_object_type, from_object_id, to_object_type, to_object_id.

list_all_hub_spot_properties

List all CRM properties for a specified object type in HubSpot. Returns each property with name, archived, createdAt, updatedAt, and dataSensitivity. Required: object_type.

get_single_hub_spot_property_by_id

Get a single CRM property by id (property name) for a specified object type in HubSpot. Returns: name, archived, createdAt, updatedAt, dataSensitivity. Required: object_type, id.

create_a_hub_spot_property

Create and return a copy of a new property for the specified object type in HubSpot. Requires object_type. Returns the created property's details including label, type, name, description, options, and other configuration fields.

update_a_hub_spot_property_by_id

Partially update a HubSpot CRM property identified by id for the specified object type; provided fields will be overwritten. Returns: name, label, description, type. Required: object_type, id.

delete_a_hub_spot_property_by_id

Archive a HubSpot CRM property (move to the recycling bin) identified by id for the specified object type. Returns an empty 204 response on success. Required: object_type, id.

list_all_hub_spot_contact_lists

List HubSpot contact lists via the legacy v1 API, including both static and dynamic lists. Returns: listId, name, dynamic, createdAt, updatedAt. Max 250 per page. This v1 API is deprecated; prefer the 2026-03 CRM Lists API for new integrations.

list_all_hub_spot_roles

List HubSpot roles (permission sets) defined on an account. Returns: id, name.

list_all_hub_spot_contact_list_results

List all contacts in a specific HubSpot contact list, including contact properties such as firstname, lastname, company, and jobtitle. Returns: vid, properties. Required: contact_list_id. Max 100 per page.

list_all_hub_spot_pipelines

List all pipelines for a specified CRM object type in HubSpot. Returns: id, label, displayOrder, archived, createdAt, updatedAt. Required: object_type.

get_single_hub_spot_pipeline_by_id

Get a single HubSpot pipeline by id for a specified object type. Returns the full pipeline object including id, label, displayOrder, stages, createdAt, updatedAt, and archived. Required: object_type, id.

list_all_hub_spot_activity_login

List HubSpot login activity logs related to account login history. Returns: userId. Max 200 results per page.

list_all_hub_spot_activity_security

List HubSpot security activity logs showing user actions related to account security. Returns critical action records with id and security event attributes. No required parameters. Max 200 results per page.

list_all_hub_spot_audit_logs

List HubSpot audit logs covering user actions for approvals, content updates, CRM object updates, security activity, and more. Returns: id, actingUserId. Available for Enterprise accounts only.

list_all_hub_spot_line_items

List a page of HubSpot line items. Returns: id, properties, createdAt, updatedAt, archived, associations. Control which fields are returned via the properties query parameter.

get_single_hub_spot_line_item_by_id

Get a single HubSpot line item by id. Returns: id, properties, createdAt, updatedAt, archived, associations. Use idProperty to look up by a unique property other than the internal object ID. Required: id.

create_a_hub_spot_line_item

Create a HubSpot line item with the given properties and optional associations. Returns the created line item including its id, properties, createdAt, updatedAt, and archived. Required: properties.

update_a_hub_spot_line_item_by_id

Partially update a HubSpot line item by id. Provided property values are overwritten; pass an empty string to clear a value. Returns the updated line item including its id, properties, createdAt, updatedAt, and archived. Required: id, properties.

delete_a_hub_spot_line_item_by_id

Archive a HubSpot line item by id, moving it to the recycling bin. Returns an empty 204 response on success. Required: id.

list_all_hub_spot_account

Get HubSpot account details. Returns: portalId, accountType, timeZone, currency, dataHostingLocation.

list_all_hub_spot_threads

List HubSpot conversations threads with optional filtering by inbox, contact, or status. Returns: id, properties, createdAt, updatedAt, archived, latestMessageTimestamp. The associatedContactId and inboxId parameters are mutually exclusive; threadStatus must be provided when using associatedContactId.

get_single_hub_spot_thread_by_id

Get a single HubSpot conversations thread by id. Returns: id, properties, createdAt, updatedAt, archived, latestMessageTimestamp. Required: id.

update_a_hub_spot_thread_by_id

Update a single HubSpot conversations thread by id — either change the thread's status or restore an archived thread. Returns the updated thread object including id, status, and archived. Required: id. A thread's status property cannot be updated if the thread is archived.

list_all_hub_spot_messages

List message history for a HubSpot conversation thread. Returns: id, text, richText, truncationStatus, createdAt, archived. Required: thread_id.

get_single_hub_spot_message_by_id

Get a single HubSpot conversation message from a thread by message id. Returns: id, text, richText, createdAt, truncationStatus. Required: thread_id, id.

create_a_hub_spot_message

Send a new message to a HubSpot Conversations thread at the current timestamp. Returns the created message object including its id, text, and createdAt. Required: thread_id.

get_single_hub_spot_original_message_content_by_id

Get the original (untruncated) content of a HubSpot conversation thread message. Returns: text, richText, truncationStatus. Required: thread_id, id. Differs from the message's own text and richText when truncationStatus is not NOT_TRUNCATED.

list_all_hub_spot_inboxes

List HubSpot conversations inboxes with optional filtering and sorting. Returns: id, createdAt, updatedAt.

get_single_hub_spot_inbox_by_id

Get a single HubSpot conversations inbox by id. Returns: id, createdAt, updatedAt. Required: id.

get_single_hub_spot_actor_by_id

Get a single HubSpot conversations actor by its actor ID. Returns the actor object including its actorId. Required: id.

list_all_hub_spot_contacts_search

Search HubSpot contacts by filtering on properties, searching through associations, and sorting results. Returns: id, properties, createdAt, updatedAt, archived. Supports text query, filter groups, sorts, and property selection including firstname, lastname, email, and phone.

list_all_hub_spot_company_search

Search HubSpot companies by filtering on properties such as name, industry, website, and more. Returns matching company records with id, properties, createdAt, updatedAt, and archived. Max 200 results per page.

list_all_hub_spot_notes_search

Search HubSpot CRM notes using filters, text query, and sort options. Returns: id, properties, createdAt, updatedAt, archived. The properties map includes note fields such as hs_note_body, hs_timestamp, and hs_object_id.

list_all_hub_spot_deals_search

Search HubSpot CRM deals by filtering on properties, searching through associations, and sorting results. Returns matching deal objects including id, properties, createdAt, updatedAt, and archived. No required parameters; provide filterGroups, sorts, and properties in the request body to refine results.

list_all_hub_spot_line_items_search

Search HubSpot CRM line items by filters, text query, and sorting options provided in the request body. Returns matching line item records including id, properties, createdAt, and updatedAt.

list_all_hub_spot_products_search

Search for products in HubSpot CRM using filter groups, property selection, and sorting criteria. Returns: id, properties, createdAt, updatedAt, archived. The properties map includes name, description, price, createdate, hs_lastmodifieddate, and hs_object_id.

list_all_hub_spot_quotes_search

Search HubSpot CRM quotes using filters, sorting, and property selection in the request body. Returns matching quote records with id, properties, createdAt, updatedAt, and archived. No individual parameters are required; the request body may be an empty object to retrieve a default page of quotes.

list_all_hub_spot_tickets_search

Search HubSpot tickets by filtering on properties, searching through associations, and sorting results. Returns: id, properties, createdAt, updatedAt, archived.

list_all_hub_spot_calls_search

Search for HubSpot calls by filtering on properties, searching through associations, and sorting results. Returns matching call records with id, properties, createdAt, updatedAt, and archived fields.

list_all_hub_spot_emails_search

Search HubSpot CRM email records using filter groups, text queries, sorts, and property selection. Returns: id, properties, createdAt, updatedAt, archived. Default properties include hs_email_subject and hs_body_preview.

list_all_hub_spot_meetings_search

Search for HubSpot CRM meetings by filtering on properties, searching through associations, and sorting results. Returns: id, properties, createdAt, updatedAt, archived.

list_all_hub_spot_tasks_search

Search for HubSpot CRM tasks using filters, property selection, and sorting. Returns matching task records with id, properties, createdAt, updatedAt, and archived.

list_all_hub_spot_site_pages

List HubSpot website pages with support for filtering by creation and update timestamps, archived status, and sorting. Returns: id, name, createdAt, updatedAt, createdBy, updatedBy, archived, archivedInDashboard. Max 100 per page.

get_single_hub_spot_site_page_by_id

Get a single HubSpot website page by id. Returns: id, name, createdAt, updatedAt, createdBy, updatedBy, archived, archivedInDashboard. Required: id.

list_all_hub_spot_blog_posts

List HubSpot CMS blog posts with optional filtering by archived status and creation/update timestamps. Returns a paged collection of blog post objects including id, name, state, slug, content, created_at, updated_at, and published_at.

get_single_hub_spot_blog_post_by_id

Get a single HubSpot blog post by its post ID. Returns the blog post object including its id. Required: id.

list_all_hub_spot_landing_pages

List HubSpot landing pages with filtering by creation and update timestamps, sorting, and selective property inclusion. Returns: id, name, createdAt, updatedAt, createdBy, updatedBy, archived. Sorted by createdAt by default; max 100 results per page.

get_single_hub_spot_landing_page_by_id

Get a HubSpot landing page by its id. Returns the full page object including id, name, createdAt, updatedAt, createdBy, and updatedBy. Required: id.

list_all_hub_spot_property_groups

List all property groups for a specified HubSpot CRM object type. Returns: name, label, displayOrder, hubspotDefined, archived. Required: object_type.

get_single_hub_spot_property_group_by_id

Get a HubSpot CRM property group by group name for a given object type. Returns: name, label, displayOrder. Required: object_type, id.

create_a_hub_spot_property_group

Create a new property group for a specified CRM object type in HubSpot. Returns the created property group including its name, label, and displayOrder. Required: object_type.

update_a_hub_spot_property_group_by_id

Update a HubSpot CRM property group by performing a partial update on the group identified by its name. Provided fields will be overwritten. Returns: name, label, displayOrder. Required: object_type, id.

delete_a_hub_spot_property_group_by_id

Delete a HubSpot CRM property group by moving it to the recycling bin. Returns an empty 204 response on success. Required: object_type, id.

list_all_hub_spot_tickets

List a page of HubSpot tickets with control over which properties and associations are returned. Returns: id, properties, createdAt, updatedAt, archived, associations.

get_single_hub_spot_ticket_by_id

Get a single HubSpot ticket by id, with control over which properties and associations are returned. Returns: id, properties, createdAt, updatedAt, archived, associations. Required: id.

create_a_hub_spot_ticket

Create a HubSpot ticket with the given properties and return a copy of the created object. Returns: id, properties, createdAt, updatedAt, archived. Required: properties.

update_a_hub_spot_ticket_by_id

Partially update a HubSpot ticket by id, overwriting provided property values. Read-only and non-existent properties will result in an error; property values can be cleared by passing an empty string. Returns: id, properties, createdAt, updatedAt, archived. Required: id.

delete_a_hub_spot_ticket_by_id

Archive a HubSpot ticket by id, moving it to the recycling bin. Returns an empty 204 response on success. Required: id.

create_a_hub_spot_timeline_event

Use this endpoint to create a new timeline event in HubSpot. The event is based on a defined event template and can include custom properties, associations (e.g., contact or deal), and timestamps. The response includes the ID and details of the created event.

get_single_hub_spot_timeline_event_by_id

Get a HubSpot timeline event instance specified by its event template ID and event ID. Returns the event instance including its id, event_template_id, and timestamp. Required: event_template_id, id.

list_all_hub_spot_stages

List all stages associated with a HubSpot CRM pipeline. Returns: id, label, displayOrder, createdAt, updatedAt, archived, metadata. Required: object_type, pipeline_id.

list_all_hub_spot_user_token_contacts

Get a HubSpot contact by its user token (utk). Returns the contact profile including vid, properties, identity-profiles, and form-submissions. Required: user_token.

list_all_hub_spot_oauth_access_token_info

Get information about a HubSpot OAuth 2.0 access token. Returns: uid, config. The access token is supplied automatically from the connected OAuth session.

list_all_hub_spot_me

Get a single HubSpot user by user_id from the user provisioning settings API. Returns: id, email, firstName, lastName. Required: user_id.

list_all_hub_spot_attachments

List message history for a HubSpot conversation thread, including attachment metadata. Returns: id, text, richText, createdAt, updatedAt, truncationStatus, archived. Required: thread_id.

hub_spot_attachments_download

Download a file attachment from HubSpot using its path and base URL. Returns the raw file content as binary data. Required: path, base.

get_single_hub_spot_attachment_by_id

Get a signed URL for a specific HubSpot file by id, useful for securely sharing private files with a limited lifespan. Returns: url, expiresAt. Required: id.

list_all_hub_spot_me_owner

Retrieve a specific HubSpot CRM owner by user_id. Returns: id, userId, email, archived, createdAt, updatedAt. Required: user_id.

list_all_hub_spot_get_owner_by_user_id

Get a HubSpot CRM owner by userId. Returns: firstName, lastName, email, userId, id, createdAt, updatedAt, archived, teams. Required: id.

list_all_hub_spot_email_campaigns

List email campaigns from HubSpot using the legacy v1 email campaigns endpoint. Returns campaign records including their id. Pagination is cursor-based via the offset parameter.

get_single_hub_spot_email_campaign_by_id

Get a single HubSpot email campaign by id. Returns: id, appId, name, lastUpdatedTime, lastActivityTime, content. Required: id.

list_all_hub_spot_email_events

List HubSpot email events from the email analytics API. Returns: id, created.

get_single_hub_spot_email_event_by_id

Get a single HubSpot email event by its created timestamp and id. Returns: id, created. Required: created, id.

list_all_hub_spot_marketing_emails

List HubSpot marketing emails with optional filtering by campaign, type, publish status, and creation/update/publish timestamps. Returns: id, type, campaign, isPublished, createdAt, updatedAt, publishedAt. Max 100 per page.

list_all_hub_spot_leads

List HubSpot CRM leads with their properties and associated object IDs. Returns each lead's id, properties, createdAt, updatedAt, archived, and associations.

get_single_hub_spot_lead_by_id

Get a single HubSpot lead by id. Returns the lead object including id, properties (hs_lead_name, hs_object_id, hubspot_owner_id, hs_lead_source, and more), associations with related contacts/deals/companies, createdAt, and updatedAt. Required: id.

create_a_hub_spot_lead

Create a lead in HubSpot with the given properties and optional associations. Returns the created lead object including its id, properties, createdAt, updatedAt, and archived flag. Required: properties.

update_a_hub_spot_lead_by_id

Partially update a HubSpot lead by id, overwriting specified property values. Returns: id, properties, createdAt, updatedAt, archived. Required: id, properties. Read-only and non-existent properties cause an error; pass an empty string to clear a value.

hub_spot_leads_search

Search HubSpot leads by filter groups, properties, and sorting criteria. Returns matching lead records including id, properties, createdAt, updatedAt, and archived. Supports up to 200 results per page.

delete_a_hub_spot_lead_by_id

Archive a HubSpot lead by id, moving it to the recycling bin. Returns an empty 204 response on success. Required: id.

list_all_hub_spot_leads_search

Search HubSpot leads using filter groups, properties, and sorting options. Returns: id, properties, createdAt, updatedAt, archived. Max 200 results per page.

list_all_hub_spot_channels

List HubSpot conversations channels with optional sorting. Returns: id, createdAt, updatedAt.

get_single_hub_spot_channel_by_id

Get a single HubSpot conversations channel by id. Returns: id, createdAt, updatedAt. Required: id.

list_all_hub_spot_files

List files stored in the HubSpot file manager with optional filters by name, type, extension, size, dates, parent folder, and more. Returns: id, name, path, size, type, extension, url, createdAt, updatedAt, expiresAt, height, width, parentFolderId, isUsableInContent, allowsAnonymousAccess, archived, fileMd5.

get_single_hub_spot_file_by_id

Get a specific HubSpot file by id. Returns the file object including id, name, path, url, type, extension, size, width, height, createdAt, updatedAt, and parentFolderId. Required: id.

hub_spot_files_get_download_url

Generate a signed download URL for a specific HubSpot file, useful for securely sharing private files with a limited lifespan. Returns: url, expiresAt, name. Required: file_id.

create_a_hub_spot_file

Upload a new file to the HubSpot file manager using multipart form data. Returns the created file object including its id, name, path, size, type, url, createdAt, and updatedAt. Required: file.

list_all_hub_spot_channel_accounts

List HubSpot conversations channel accounts with optional filters by channel, inbox, and archived status. Returns: id, channelId, inboxId, deliveryIdentifier.

get_single_hub_spot_channel_account_by_id

Get a single HubSpot channel account by id. Returns: id, channelId, inboxId, deliveryIdentifier. Required: id.

create_a_hub_spot_custom_event

Send a single custom behavioral event completion to HubSpot. Returns an empty 204 response on success. Required: event_name. At least one contact identifier (email, utk, or object_id) should be provided to associate the event with a contact. Supports up to 1250 requests per second; limit of 30 million completions per month per account.

hub_spot_custom_events_send_batch

Send a batch of custom behavioral event completions in HubSpot. Returns an empty 204 response on success. Required: inputs. Supports batches of up to 500 event completions per request.

list_all_hub_spot_custom_event_definitions

List existing HubSpot custom behavioral event definitions. Returns: name, created_at, updated_at. Supports optional search filtering, sort order, and including property definitions in the response. There is a limit of 500 unique event definitions per account.

get_single_hub_spot_custom_event_definition_by_id

Get a single HubSpot custom event definition by its event name. Returns: name, attributes. Required: id.

create_a_hub_spot_custom_event_definition

Create a custom event definition in HubSpot. Returns the created event definition object along with a Location header containing the URL of the newly created resource. A request body is required. Limited to 500 unique event definitions per account.

update_a_hub_spot_custom_event_definition_by_id

Update a specific custom event definition in HubSpot by its event name. Returns the updated definition including its name, description, and archived status. Required: id.

delete_a_hub_spot_custom_event_definition_by_id

Delete a custom event definition in HubSpot by event name. Returns an empty 204 response on success. Required: id.

list_all_hub_spot_event_types

List available HubSpot event types that can be queried via the Event Analytics API. Returns: name, description, displayName. No required parameters.

list_all_hub_spot_event_data

Retrieve event data filtered by objectType and objectId in HubSpot. Returns event instances with fields such as event type, timestamp, and associated CRM object details.

list_all_hub_spot_reports_events

List analytics events from HubSpot's Reporting v2 API. Returns analytics event data for content and events tracked in the account. No required parameters.

get_single_hub_spot_reports_event_by_id

Get a single analytics event from HubSpot's legacy v2 reporting API by id. Returns the event object including its id. Required: id. This is a legacy endpoint accessed via the business-intelligence scope.

list_all_hub_spot_workflows

List HubSpot automation workflows (flows) available in your account. Returns: id.

get_single_hub_spot_workflow_by_id

Get a specific HubSpot automation flow (workflow) by id. Returns the full automation flow object including its id, current configuration, and status. Required: id.

create_a_hub_spot_workflow

Create a new workflow in HubSpot. Returns the created workflow details including its id and configuration.

update_a_hub_spot_workflow_by_id

Update an existing HubSpot automation flow by id. Returns: id. Required: id.

delete_a_hub_spot_workflow_by_id

Delete a HubSpot automation flow by id. This operation permanently removes the flow and cannot be undone. Returns an empty 204 response on success. Required: id.

list_all_hub_spot_blog_authors

List all HubSpot blog authors with support for paging and filtering by creation and update times. Returns: id, name, created, updated, createdBy, updatedBy. Max 100 results per page.

create_a_hub_spot_blog_author

Create a blog author in HubSpot. Requires fullName. Include slug to set the URL of the blog author profile page. Returns the created blog author's details.

update_a_hub_spot_blog_author_by_id

Sparse-update a HubSpot blog author by id — only the fields you want to change need to be included in the request body. Returns the updated blog author object including id, name, created, updated, createdBy, and updatedBy. Required: id.

create_a_hub_spot_blog_tag

Create a new blog tag in HubSpot. Returns the created Tag object including name, createdAt, updatedAt, createdBy, and updatedBy. Requires a request body with the tag details.

update_a_hub_spot_blog_tag_by_id

Update a HubSpot blog tag by id with a partial Tag object. Returns the updated blog tag including id, createdAt, updatedAt, and archived. Required: id.

list_all_hub_spot_blog_tags

List HubSpot blog tags with optional filtering by creation and update date ranges, archived status, property selection, and sorting. Returns: id, archived, createdAt, updatedAt.

list_all_hub_spot_carts

List all cart objects in HubSpot. Control which fields are returned via the `properties` query parameter. Returns each cart's id, properties, createdAt, updatedAt, and archived status.

get_single_hub_spot_cart_by_id

Get a specific cart in HubSpot by id. The id refers to the internal object ID by default, or optionally any unique property value when idProperty is provided. Returns: id, properties, createdAt, updatedAt, archived, associations. Required: id.

create_a_hub_spot_cart

Create a cart in HubSpot with the given properties and optional associations. Returns the created cart object including its id, properties, createdAt, and updatedAt. Required: properties.

update_a_hub_spot_cart_by_id

Partially update a HubSpot cart by id with a set of property values. Provided property values will be overwritten; pass an empty string to clear a value. Read-only and non-existent properties will result in an error. Returns: id, properties, createdAt, updatedAt, archived. Required: id.

delete_a_hub_spot_cart_by_id

Delete a HubSpot cart by moving it to the recycling bin. Returns an empty 204 response on success. Required: id.

list_all_hub_spot_carts_search

Search for HubSpot carts using filter groups, property selection, and sorting criteria. Returns matching cart records including id, properties, createdAt, updatedAt, and archived. Requires a request body with search criteria.

list_all_hub_spot_discounts

List a page of HubSpot discounts, controlling returned fields via the `properties` query param. Returns: id, properties, createdAt, updatedAt, archived, associations. Optional filters: archived, associations, properties, propertiesWithHistory.

get_single_hub_spot_discount_by_id

Get a single HubSpot discount by id. Returns: id, properties, createdAt, updatedAt, archived, associations. Required: id. Optional: archived, associations, idProperty, properties, propertiesWithHistory.

create_a_hub_spot_discount

Create a HubSpot discount with the given properties and associations. Returns the created discount object including its id, properties, createdAt, updatedAt, and archived. Required: properties.

update_a_hub_spot_discount_by_id

Perform a partial update of a HubSpot discount by id, overwriting supplied property values. Returns: id, properties, createdAt, updatedAt, archived. Required: id. Pass property values as empty strings to clear them; read-only and non-existent properties result in an error. Optional: idProperty.

delete_a_hub_spot_discount_by_id

Archive a HubSpot discount by id, moving it to the recycling bin. Returns an empty 204 response on success. Required: id.

list_all_hub_spot_discounts_search

Search HubSpot discounts by filtering on properties, searching through associations, and sorting results. Returns matching discount records with id, properties, createdAt, updatedAt, and archived.

list_all_hub_spot_fees

List HubSpot fee objects. Returns: id, properties, createdAt, updatedAt, archived, associations. Control which fields are returned via the properties query parameter.

get_single_hub_spot_fee_by_id

Get a single HubSpot fee by id. The id refers to the internal object ID by default, or any unique property value when idProperty is specified. Returns: id, properties, createdAt, updatedAt, archived, associations. Required: id.

create_a_hub_spot_fee

Create a fee in HubSpot with the given properties. Returns the created fee object including its id, properties, createdAt, updatedAt, and archived. Required: properties.

update_a_hub_spot_fee_by_id

Partially update a HubSpot fee object by id, overwriting the provided property values. Returns the updated fee object including id, properties, createdAt, updatedAt, and archived. Required: id. Property values can be cleared by passing an empty string; read-only and non-existent properties will result in an error.

delete_a_hub_spot_fee_by_id

Archive a HubSpot fee object by id, moving it to the recycling bin. Returns an empty 204 response on success. Required: id.

list_all_hub_spot_fees_search

Search for HubSpot fees using filters, sorting, properties, and pagination criteria defined in the request body. Returns: id, properties, createdAt, updatedAt, archived.

list_all_hub_spot_invoices

List a page of HubSpot invoices with control over which properties are returned via the properties query param. Returns: id, properties, createdAt, updatedAt, archived, associations.

get_single_hub_spot_invoice_by_id

Get a single HubSpot invoice by id. Returns: id, properties, createdAt, updatedAt, archived, associations. Required: id.

create_a_hub_spot_invoice

Create a HubSpot invoice with the given properties and return a copy of the object including the ID. Returns: id, properties, createdAt, updatedAt, archived. Required: properties.

update_a_hub_spot_invoice_by_id

Update a HubSpot invoice by id with a partial set of property values. Returns: id, properties, createdAt, updatedAt, archived. Required: id. Read-only and non-existent properties will cause an error; pass an empty string to clear a value.

delete_a_hub_spot_invoice_by_id

Delete a HubSpot invoice by id, moving it to the recycling bin. Returns an empty 204 response on success. Required: id.

list_all_hub_spot_invoices_search

Search HubSpot CRM invoices using filter criteria, sorting options, and specified properties. Returns matching invoice records with id, properties, createdAt, and updatedAt. Supports complex queries with multiple filter groups and pagination.

list_all_hub_spot_orders

List a page of HubSpot CRM orders, controlling which property values are returned via the properties query param. Returns: id, properties, createdAt, updatedAt, archived, associations.

get_single_hub_spot_order_by_id

Get a single HubSpot order by id. Returns the order object including id, properties, createdAt, updatedAt, archived, and associations. Use the optional idProperty query parameter to look up the order by a unique property value instead of the internal object ID. Required: id.

create_a_hub_spot_order

Create a new order in HubSpot CRM with the given properties and optional associations. Returns the created order object including id, properties, createdAt, and updatedAt. Required: properties.

update_a_hub_spot_order_by_id

Partially update a HubSpot order by id, overwriting the provided property values. Read-only and non-existent properties will cause an error; pass an empty string to clear a value. Returns: id, properties, createdAt, updatedAt, archived. Required: id.

delete_a_hub_spot_order_by_id

Delete a HubSpot order by id, moving it to the recycling bin. Returns an empty 204 response on success. Required: id.

list_all_hub_spot_orders_search

Search for orders in HubSpot CRM by filtering on properties and sorting results. Returns: id, properties, createdAt, updatedAt, archived.

list_all_hub_spot_payments

List a page of HubSpot commerce payments. Returns: id, properties, createdAt, updatedAt, archived, associations. Use the properties query param to control which property values are included in each record. Using propertiesWithHistory reduces the maximum number of results that can be returned per request.

get_single_hub_spot_payment_by_id

Get a single HubSpot commerce payment by its internal object ID, or by a unique property value when idProperty is supplied. Returns: id, properties, createdAt, updatedAt, archived, associations. Required: id.

list_all_hub_spot_payments_search

Search HubSpot commerce payments by filter groups, properties, and sort criteria using the CRM Search API. Returns matching payment records with id, properties, createdAt, updatedAt, and archived. Required: a search request body.

list_all_hub_spot_quotes

List a page of HubSpot quotes. Returns: id, properties, createdAt, updatedAt, archived, associations. Control which fields are returned via the properties query parameter.

get_single_hub_spot_quote_by_id

Get a single HubSpot quote by id. Returns: id, properties, createdAt, updatedAt, archived, associations. Required: id. Optionally use idProperty to look up by a unique property value instead of the internal ID.

create_a_hub_spot_quote

Create a HubSpot quote with the given properties and optional associations. Returns the created quote including id, properties, createdAt, updatedAt, archived, associations. Required: properties.

update_a_hub_spot_quote_by_id

Partially update a HubSpot quote by id, overwriting the provided property values. Returns: id, properties, createdAt, updatedAt, archived. Required: id. Read-only and non-existent properties cause errors; pass an empty string to clear a property value.

delete_a_hub_spot_quote_by_id

Archive a HubSpot quote by id, moving it to the recycling bin. Returns an empty 204 response on success. Required: id.

list_all_hub_spot_subscriptions

List HubSpot commerce subscription records. Returns: id, properties, createdAt, updatedAt, archived, associations.

get_single_hub_spot_subscription_by_id

Get a single HubSpot commerce subscription by id. Returns: id, properties, createdAt, updatedAt, archived, associations. Required: id.

list_all_hub_spot_subscriptions_search

Search HubSpot CRM subscription records by filtering on properties, associations, and sorting criteria. Returns matching records with id, properties, createdAt, updatedAt, and archived.

list_all_hub_spot_taxes

List HubSpot taxes. Returns each tax record with id, properties, createdAt, updatedAt, archived, and associations. Use the properties query param to control which fields are returned.

get_single_hub_spot_tax_by_id

Get a single HubSpot tax by id. Returns: id, properties, createdAt, updatedAt, archived, associations. Required: id. Use idProperty to look up by a unique property instead of the internal object ID.

create_a_hub_spot_tax

Create a HubSpot tax with the given properties. Returns: id, properties, createdAt, updatedAt, archived. Required: properties.

update_a_hub_spot_tax_by_id

Partially update a HubSpot tax by id. Returns: id, properties, createdAt, updatedAt, archived. Required: id, properties. Property values can be cleared by passing an empty string.

delete_a_hub_spot_tax_by_id

Archive a HubSpot tax by id, moving it to the recycling bin. Returns an empty 204 response on success. Required: id.

list_all_hub_spot_taxes_search

Search for taxes in HubSpot CRM using filters, sorts, and property selection. Returns matching tax objects with id, properties, createdAt, updatedAt, and archived.

list_all_hub_spot_engagements

List all engagement records (calls, emails, meetings, notes, and tasks) in HubSpot with pagination. Returns each engagement including its id, type, timestamp, ownerId, and type-specific metadata. No required parameters beyond pagination.

get_single_hub_spot_engagement_by_id

Get a single HubSpot engagement by id. Returns the engagement record including its id and type-specific engagement data that varies by engagement type (call, email, meeting, note, or task). Required: id.

create_a_hub_spot_engagement

Create a new engagement record in HubSpot such as a call, email, meeting, note, or task. Returns the created engagement record including its id and engagement details with type-specific fields depending on the engagement type. Required: engagement.

update_a_hub_spot_engagement_by_id

Update an existing HubSpot engagement record (call, email, meeting, note, or task) by id. Returns the updated engagement object including its id, type, associations, and metadata. Required: id.

delete_a_hub_spot_engagement_by_id

Delete a HubSpot engagement (call, email, meeting, note, or task) by id. Returns an empty 204 response on success. Required: id.

list_all_hub_spot_communications

List a page of communications in HubSpot. Returns: id, properties, createdAt, updatedAt, archived, associations. Using propertiesWithHistory to retrieve property value history reduces the maximum number of results returned per request.

get_single_hub_spot_communication_by_id

Get a single communication object in HubSpot by its internal ID, or optionally by a unique property value when specifying the idProperty query parameter. Returns: id, properties, createdAt, updatedAt, archived, associations. Required: id.

create_a_hub_spot_communication

Create a communication in HubSpot CRM with the given properties and optional associations to other CRM records. Returns the created communication object including id, properties, createdAt, updatedAt, and archived. Required: properties.

update_a_hub_spot_communication_by_id

Partially update a HubSpot communication by id. Provided property values are overwritten; read-only or non-existent properties cause an error, and values can be cleared by passing an empty string. Returns: id, properties, createdAt, updatedAt, archived, status, message, errorType, correlationId, policyName, requestId. Required: id, properties.

delete_a_hub_spot_communication_by_id

Delete a HubSpot communication by id, moving it to the recycling bin. Returns an empty 204 response on success. Required: id.

list_all_hub_spot_communications_search

Search HubSpot communications by filtering on properties, searching through associations, and sorting results. Returns: id, properties, createdAt, updatedAt, archived. Supports up to 200 results per page.

list_all_hub_spot_postal_mails

List postal mail records in HubSpot CRM. Returns: id, properties, createdAt, updatedAt, archived, associations. Control which properties and associations are returned via the corresponding query parameters.

get_single_hub_spot_postal_mail_by_id

Get a single postal mail record by id in HubSpot CRM. Returns: id, properties, createdAt, updatedAt, archived, associations. Required: id.

create_a_hub_spot_postal_mail

Create a new postal mail record in HubSpot CRM with the given properties and optional associations. Returns: id, properties, createdAt, updatedAt, archived. Required: properties.

update_a_hub_spot_postal_mail_by_id

Update an existing postal mail record by id in HubSpot CRM with the given properties. Returns: id, properties, createdAt, updatedAt, archived. Required: id, properties.

delete_a_hub_spot_postal_mail_by_id

Delete a postal mail record by id in HubSpot CRM. Returns an empty 204 response on success. Required: id.

list_all_hub_spot_postal_mails_search

Search for postal mail records in HubSpot CRM by filtering on properties, searching through associations, and sorting results. Returns: id, properties, createdAt, updatedAt, archived.

get_single_hub_spot_video_conferencing_setting_by_id

Get video conferencing extension settings for a HubSpot app by id. Returns the app's ExternalSettings object containing its video conference extension configuration. Required: id.

update_a_hub_spot_video_conferencing_setting_by_id

Create or update HubSpot video conferencing extension settings for an app by id. Returns the updated settings object including its id and schema-specific attributes. Required: id.

delete_a_hub_spot_video_conferencing_setting_by_id

Delete video conferencing extension settings for a HubSpot app by id. Returns an empty 204 response on success. Required: id.

list_all_hub_spot_active_imports

List active imports in HubSpot CRM. Returns each import record's id; the full record shape follows HubSpot's PublicImportResponse schema.

get_single_hub_spot_active_import_by_id

Get a HubSpot CRM import by id. Returns a complete summary of the import record including any updates, with id and attributes fields. Required: id.

create_a_hub_spot_active_import

Create a new CRM import in HubSpot by uploading a file along with an import configuration. Returns: id, createdAt, updatedAt. Required: files, importRequest. The upstream API expects a multipart/form-data body; the importRequest field is a JSON string specifying the import name, file format, and column mappings.

list_all_hub_spot_feedback_submissions

List HubSpot feedback submissions. Control which fields are returned via the `properties` query param. Returns: id, properties, createdAt, updatedAt, archived, associations.

get_single_hub_spot_feedback_submission_by_id

Get a single HubSpot feedback submission by id. Returns: id, properties, createdAt, updatedAt, archived, associations. Required: id.

list_all_hub_spot_feedback_submissions_search

Search HubSpot feedback submissions using defined filter groups, properties, and sorting options. Returns: id, properties, createdAt, updatedAt, archived.

list_all_hub_spot_goal_targets

List a page of HubSpot goal targets. Returns each goal target's id, properties, createdAt, updatedAt, archived, and optionally associations. Control which fields are returned via the properties query param.

get_single_hub_spot_goal_target_by_id

Get a single HubSpot goal target by id. Returns: id, properties, createdAt, updatedAt, archived, associations. Required: id. Use the idProperty query param to look up by a unique property value instead of the internal ID.

create_a_hub_spot_goal_target

Create a HubSpot goal target with the given properties and optional associations. Returns the created object including id, properties, createdAt, updatedAt, and archived. Required: properties.

update_a_hub_spot_goal_target_by_id

Partially update a HubSpot goal target by id. Provided property values will be overwritten; read-only and non-existent properties will cause an error. Pass an empty string to clear a property value. Returns: id, properties, createdAt, updatedAt, archived, associations. Required: id.

delete_a_hub_spot_goal_target_by_id

Delete a HubSpot goal target by id, moving it to the recycling bin. Returns an empty 204 response on success. Required: id.

list_all_hub_spot_goal_targets_search

Search for goal targets in HubSpot CRM using filters, properties, and sorting. Returns: id, properties, createdAt, updatedAt, archived.

list_all_hub_spot_partner_clients

List partner clients in HubSpot with optional filtering by archived status, associations, and specific properties. Returns: id, properties, createdAt, updatedAt, archived, associations.

get_single_hub_spot_partner_client_by_id

Get a specific partner client by id in HubSpot, including selected properties and associations. Returns: id, properties, createdAt, updatedAt, archived, associations. Required: id.

update_a_hub_spot_partner_client_by_id

Update properties of a specific partner client in HubSpot by id. Returns: id, properties, createdAt, updatedAt, archived. Required: id, properties.

list_all_hub_spot_partner_clients_search

Search for HubSpot partner clients using defined filters, properties, and sorting options. Returns matching records including id, properties, createdAt, updatedAt, and archived.

list_all_hub_spot_products

List HubSpot products. Control which properties are returned via the properties query param. Returns: id, properties, createdAt, updatedAt, archived.

get_single_hub_spot_product_by_id

Get a single HubSpot product by id. Control which properties are returned via the properties query param. Returns: id, properties, createdAt, updatedAt, archived, associations. Required: id.

create_a_hub_spot_product

Create a new product in HubSpot CRM with the given properties and optionally set associations at creation time. Returns the created product object including its id, properties, createdAt, updatedAt, and archived. Required: properties.

update_a_hub_spot_product_by_id

Update a HubSpot product by id with a partial set of property values. Returns: id, properties, createdAt, updatedAt, archived. Required: id. Read-only and non-existent properties will result in an error; pass an empty string to clear a property value.

delete_a_hub_spot_product_by_id

Archive a HubSpot product by id, moving it to the recycling bin. Returns an empty 204 response on success. Required: id.

list_all_hub_spot_schemas

List all HubSpot custom object schemas in the account. Returns: id, name, createdAt, updatedAt, labels, properties, associations.

get_single_hub_spot_schema_by_id

Get a single HubSpot custom object schema by its object type ID or fully qualified name. Returns: id, name, createdAt, updatedAt, labels, properties, associations. Required: id.

create_a_hub_spot_schema

Create a new HubSpot custom object schema by defining its properties and associations. Returns: id, name, createdAt, updatedAt, labels, properties, associations.

update_a_hub_spot_schema_by_id

Update attributes of a HubSpot custom object schema, such as properties and labels, by its object type ID or fully qualified name. Returns: id, name, createdAt, updatedAt, labels, properties, associations. Required: id.

delete_a_hub_spot_schema_by_id

Delete a HubSpot custom object schema by its object type ID or fully qualified name. Returns an empty 204 response on success. Required: id.

create_a_hub_spot_email_single_send

Send a single transactional email asynchronously in HubSpot. Returns the email send status including statusId, which can be used to query the Email Send Status API for delivery progress.

list_all_hub_spot_forms

List HubSpot marketing form definitions with optional filtering by form type and archived status. Returns: id, formType, archived, createdAt, updatedAt.

get_single_hub_spot_form_by_id

Get a single HubSpot marketing form definition by id. Returns: id, formType, archived, createdAt, updatedAt. Required: id.

create_a_hub_spot_form

Create a new HubSpot marketing form definition by providing form configuration in the request body. Returns the created form object including id, name, createdAt, and updatedAt.

update_a_hub_spot_form_by_id

Partially update a HubSpot form definition by id, modifying only the components supplied in the request body. Returns the updated form object including its id, name, formType, createdAt, and updatedAt. Required: id.

delete_a_hub_spot_form_by_id

Archive a HubSpot form definition by id. New submissions will not be accepted and the form definition will be permanently deleted after 3 months. Returns an empty 204 response on success. Required: id.

list_all_hub_spot_marketing_events

Get all marketing events in HubSpot. Returns marketing events sorted by objectId with their properties.

get_single_hub_spot_marketing_event_by_id

Get details of a Marketing Event by id in HubSpot. Returns fields including eventName, eventDescription, eventType, eventStatus, eventOrganizer, startDateTime, endDateTime, attendees, registrants, cancellations, noShows, eventCompleted, eventCancelled, externalEventId, createdAt, updatedAt, appInfo, and customProperties.

create_a_hub_spot_marketing_event

Create a new marketing event in HubSpot with startDateTime, eventName, eventOrganizer, externalEventId, and externalAccountId. Returns details of the created event including eventName, eventType, eventUrl, and eventDescription.

update_a_hub_spot_marketing_event_by_id

Update details of an existing Marketing Event by id in HubSpot. Returns updated event fields including eventName, eventDescription, eventType, startDateTime, endDateTime, eventCancelled, and eventOrganizer.

delete_a_hub_spot_marketing_event_by_id

Delete marketing event by id in HubSpot. Returns no content on success.

list_all_hub_spot_list_memberships

List HubSpot CRM list memberships for a given list, ordered by recordId. Returns: recordId, createTimestamp. Required: list_id. Maximum 250 records per page.

list_all_hub_spot_objects

List HubSpot CRM objects of a given object type (e.g. contacts, companies, deals, tickets). Returns: id, properties, createdAt, updatedAt, archived, associations. Required: object_type.

list_all_hub_spot_contacts_dynamic

Search HubSpot contacts by filtering on contact properties such as firstname, lastname, email, phone, and address. Returns: id, properties, createdAt, updatedAt, archived.

list_all_hub_spot_companies_dynamic

Search HubSpot companies incrementally, sorted by last-modified date. Returns: id, properties, createdAt, updatedAt, archived, url. Uses cursor pagination driven by hs_lastmodifieddate, so it is suited to repeated sync runs rather than ad-hoc browsing. Returns a fixed set of 16 company properties.

list_all_hub_spot_leads_dynamic

Search HubSpot leads incrementally, sorted by last-modified date. Returns: id, properties, createdAt, updatedAt, archived. Uses cursor pagination driven by hs_lastmodifieddate, so it is suited to repeated sync runs rather than ad-hoc browsing. Requires the crm.objects.leads.read scope.

get_single_hub_spot_webhook_setting_by_id

Get the HubSpot app-level webhook settings, including the webhook target URL, throttle configuration, and create/update timestamps. Returns: createdAt, targetUrl, throttling, updatedAt. Required: developer_app_id, developer_api_key.

update_a_hub_spot_webhook_setting_by_id

Update the HubSpot app-level webhook settings by replacing the existing target URL and throttling configuration. Returns: createdAt, targetUrl, throttling, updatedAt. Required: developer_app_id, developer_api_key.

list_all_hub_spot_webhooks

List HubSpot webhook event subscriptions configured for the developer app. Returns: id, eventType, active, createdAt, updatedAt, propertyName.

get_single_hub_spot_webhook_by_id

Get a single HubSpot webhook event subscription by id. Returns: id, eventType, active, createdAt, updatedAt, propertyName. Required: id.

create_a_hub_spot_webhook

Create a HubSpot webhook event subscription for the developer app. Returns the created subscription including id, eventType, active, createdAt, updatedAt, and propertyName.

update_a_hub_spot_webhook_by_id

Update a HubSpot webhook event subscription by id. Returns the updated subscription including id, eventType, active, createdAt, updatedAt, and propertyName. Required: id.

delete_a_hub_spot_webhook_by_id

Delete a HubSpot webhook event subscription by id. Returns an empty 204 response on success. Required: id.

Why Truto

Why use Truto’s MCP server for HubSpot

Other MCP servers give you a static tool list for one app. Truto gives you a managed, multi-tenant MCP infrastructure across 700+ integrations.

01

Auto-generated, always up to date

Tools are dynamically generated from curated documentation — not hand-coded. As integrations evolve, tools stay current without manual maintenance.

02

Fine-grained access control

Scope each MCP server to read-only, write-only, specific methods, or tagged tool groups. Expose only what your AI agent needs — nothing more.

03

Multi-tenant by design

Each MCP server is scoped to a single connected account with its own credentials. The URL itself is the auth token — no shared secrets, no credential leaking across tenants.

04

Works with every MCP client

Standard JSON-RPC 2.0 protocol. Paste the URL into Claude, ChatGPT, Cursor, or any MCP-compatible agent framework — tools are discovered automatically.

05

Built-in auth, rate limits, and error handling

Tool calls execute through Truto’s proxy layer with automatic OAuth refresh, rate-limit handling, and normalized error responses. No raw API plumbing in your agent.

06

Expiring and auditable servers

Create time-limited MCP servers for contractors or automated workflows. Optional dual-auth requires both the URL and a Truto API token for high-security environments.

Unified APIs

Unified APIs for HubSpot

Skip writing code for every integration. Use Truto’s category-specific Unified APIs out of the box or customize the mappings with AI.

Unified Knowledge Base API

Page-Content

Represents the content of a page

View Docs

Pages

Represents the pages, posts, articles in a knowledge base

View Docs

Unified CRM API

Accounts

The accounts represent a company in a CRM.

View Docs

Contacts

The contacts represent an existing point of contact at a company in a CRM.

View Docs

Conversations

Conversations represent inbox conversation threads in a CRM (e.g. HubSpot Conversations, Service Cloud Messaging).

View Docs

Engagement Types

The engagement types represent an interaction activity in a CRM.

View Docs

Engagements

The engagements represent an interaction noted in a CRM.

View Docs

Field Groups

Represents a group of fields in a CRM.

View Docs

Fields

The fields of entities in a CRM.

View Docs

Leads

The leads represent a potential customer in a CRM.

View Docs

Line Items

The line items represent product line items associated with opportunities/deals in a CRM.

View Docs

Messages

Messages represent individual messages within a CRM conversation.

View Docs

Notes

The notes represent a note on another object in a CRM.

View Docs

Opportunities

The opportunities represent an opportunity in a CRM.

View Docs

Pipelines

View Docs

Products

The products represent sellable products in a CRM catalog.

View Docs

Quotes

The quotes represent quotes associated with opportunities/deals in a CRM.

View Docs

Stages

The stages represent a stage of an opportunity in a CRM.

View Docs

Tasks

The tasks represent a task in a CRM.

View Docs

Users

The users represent a user in a CRM.

View Docs

Views

View Docs

Unified User Directory API

Activities

Activities are the actions performed by users in the source application.

View Docs

Roles

The Role object represents a role of a User.

View Docs

Users

The User object represents a User.

View Docs

Unified Ticketing API

Accounts

Accounts represent the companies or organizations that you are in contact with. Accounts have one or more Contacts associated with them.

View Docs

Attachments

Attachments are the files associated with a ticket or a comment.

View Docs

Collections

Tickets and contacts can be grouped into Collections. Collection resource usually maps to the various grouping systems used in the underlying product. Some examples are lists, projects, epics, etc. You can differentiate between these grouping systems using the type attribute of a Collection.

View Docs

Comments

Comments represent the communication happening on a Ticket, both between a User and a Contact and the internal things like notes, private comments, etc. A Ticket can have one or more Comments.

View Docs

Contacts

Contact represent the external people you are in contact with. These could be customers, leads, etc. Contacts can be associated with an Account if the underlying product supports it.

View Docs

Fields

Fields represent the attributes defined for various entities in the underlying product. Depending on the underlying product, custom attributes can be defined by a User on various entities like Ticket, Contact, etc. is_user_defined attribute within Field can be used to differentiate between custom and system defined Fields.

View Docs

Ticket Priorities

Ticket Priorities represent the intended order in which the Tickets should be worked on. Some products provide customizing the Ticket Priorities.

View Docs

Ticket Status

Ticket Status represents the completion level of the Ticket. Some products provide customizing the Ticket Status.

View Docs

Ticket Types

Ticket Types represent the classification system used by the underlying products for Tickets. Some examples are bugs, feature, incident, etc.

View Docs

Tickets

Core resource which represents some work that needs to be carried out. Tickets are usually mapped to issues, tasks, work items, etc. depending on the underlying product.

View Docs

Users

Users represent the people using the underlying ticketing system. They are usually called agents, team members, admins, etc.

View Docs

Workspaces

Workspaces represent the top-level subdivision in a ticketing system. They usually have their own set of settings, tickets, statuses, priorities and users. Some of the usual terminologies used by the products for the top-level subdivision are projects, bases, spaces, workspace, etc. A Workspace could belong to an Organization.

View Docs

Unified Search API

Search

Search endpoint for all the apps.

View Docs

How It Works

From zero to integrated

Go live with HubSpot in under an hour. No boilerplate, no maintenance burden.

01

Link your customer’s HubSpot account

Use Truto’s frontend SDK to connect your customer’s HubSpot account. We handle all OAuth and API key flows — you don’t need to create the OAuth app.

02

We handle authentication

Don’t spend time refreshing access tokens or figuring out secure storage. We handle it and inject credentials into every API request.

03

Call our API, we call HubSpot

Truto’s Proxy API is a 1-to-1 mapping of the HubSpot API. You call us, we call HubSpot, and pass the response back in the same cycle.

04

Unified response format

Every response follows a single format across all integrations. We translate HubSpot’s pagination into unified cursor-based pagination. Data is always in the result attribute.

FAQs

Common questions about HubSpot on Truto

Authentication, rate limits, data freshness, and everything else you need to know before you integrate.

What authentication method does the HubSpot integration use?

Truto handles HubSpot's OAuth 2.0 flow end to end—token exchange, refresh, and storage. Your end users authorize via a managed connect dialog, and you never touch raw credentials.

How does Truto handle HubSpot's API rate limits?

Truto automatically manages pagination, retries, and backoff against HubSpot's per-app and per-account rate limits (typically 100-150 requests per 10 seconds depending on the HubSpot plan tier), so your integration doesn't need to implement throttling logic.

Can I read and write custom properties on HubSpot objects?

Yes. Beyond the standard fields mapped by the Unified CRM API, you can read and write custom properties on Contacts, Companies, and Deals using Truto's proxy or additional_fields support, letting you push proprietary data like health scores or subscription tiers.

Which HubSpot objects are supported through the Unified CRM API?

The Unified CRM API maps Contacts, Companies, Deals, Leads, Notes, Tasks, Users (Owners), and Pipelines. For HubSpot-specific endpoints not covered by the unified model, you can use Truto's proxy mode to call any HubSpot API directly.

Do my end users need a specific HubSpot plan for the integration to work?

The core CRM objects (Contacts, Companies, Deals, Owners) are available on HubSpot's free tier. Some features like custom objects and certain workflow triggers require Professional or Enterprise plans on the end user's HubSpot account.

How does Truto handle association between HubSpot objects—like linking a Contact to a Company or Deal?

Truto preserves HubSpot's native association model. When you create or read Contacts, Companies, or Deals, associated object IDs are included in the response, and you can create associations when writing records—so your integration maintains the relational structure your end users expect.

HubSpot

Get HubSpot integrated into your app

Our team understands what it takes to make a HubSpot integration successful. A short, crisp 30 minute call with folks who understand the problem.