--- title: HubSpot API Integration on Truto slug: hubspot category: CRM canonical: "https://truto.one/integrations/detail/hubspot/" --- # HubSpot API Integration on Truto **Category:** CRM **Status:** Generally available ## Unified APIs ### Unified Knowledge Base API - **Page-Content** — Represents the content of a page - **Pages** — Represents the pages, posts, articles in a knowledge base ### Unified CRM API - **Accounts** — The accounts represent a company in a CRM. - **Contacts** — The contacts represent an existing point of contact at a company in a CRM. - **Conversations** — Conversations represent inbox conversation threads in a CRM (e.g. HubSpot Conversations, Service Cloud Messaging). - **Engagement Types** — The engagement types represent an interaction activity in a CRM. - **Engagements** — The engagements represent an interaction noted in a CRM. - **Field Groups** — Represents a group of fields in a CRM. - **Fields** — The fields of entities in a CRM. - **Leads** — The leads represent a potential customer in a CRM. - **Line Items** — The line items represent product line items associated with opportunities/deals in a CRM. - **Messages** — Messages represent individual messages within a CRM conversation. - **Notes** — The notes represent a note on another object in a CRM. - **Opportunities** — The opportunities represent an opportunity in a CRM. - **Pipelines** — - **Products** — The products represent sellable products in a CRM catalog. - **Quotes** — The quotes represent quotes associated with opportunities/deals in a CRM. - **Stages** — The stages represent a stage of an opportunity in a CRM. - **Tasks** — The tasks represent a task in a CRM. - **Users** — The users represent a user in a CRM. - **Views** — ### Unified User Directory API - **Activities** — Activities are the actions performed by users in the source application. - **Me** — - **Roles** — The Role object represents a role of a User. - **Users** — The User object represents a User. ### 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. - **Attachments** — Attachments are the files associated with a ticket or a comment. - **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. - **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. - **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. - **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. - **Ticket Priorities** — Ticket Priorities represent the intended order in which the Tickets should be worked on. Some products provide customizing the Ticket Priorities. - **Ticket Status** — Ticket Status represents the completion level of the Ticket. Some products provide customizing the Ticket Status. - **Ticket Types** — Ticket Types represent the classification system used by the underlying products for Tickets. Some examples are bugs, feature, incident, etc. - **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. - **Users** — Users represent the people using the underlying ticketing system. They are usually called agents, team members, admins, etc. - **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. ### Unified Search API - **Search** — Search endpoint for all the apps. ## MCP-ready AI tools Truto exposes 284 tools for HubSpot that AI agents can call directly. - **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. - **delete_a_hub_spot_task_by_id** — Delete a HubSpot task by id. The task moves to the recycling bin. Returns an empty response on success. - **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: token, user, user_id, hub_id, hub_domain, app_id, scopes, token_type and expires_in. 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. ## How it works 1. **Link your customer's HubSpot account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach HubSpot.** The Proxy API is a 1-to-1 mapping of the HubSpot API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **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. - **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. - **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. - **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. - **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 - **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. - **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. - **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. - **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. - **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. - **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. ## FAQs ### 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. ## Related reading - [How to Architect a Bidirectional HubSpot Sync (Without Infinite Loops)](https://truto.one/blog/how-to-architect-a-bidirectional-hubspot-sync-without-infinite-loops/) — A definitive engineering guide to building a bidirectional HubSpot sync. Learn how to handle API rate limits, dynamic schema mapping, and infinite webhook loops. - [Bidirectional HubSpot Sync Tutorial: Rate Limits, Loops, & Reconciliation](https://truto.one/blog/bidirectional-hubspot-sync-tutorial-rate-limits-reconciliation/) — Learn how to architect a reliable bidirectional HubSpot sync. This technical guide covers handling 429 rate limits, preventing infinite webhook loops, and schema normalization. - [How to Build a HubSpot Integration: 2026 Architecture Guide](https://truto.one/blog/how-do-i-build-a-hubspot-integration-2026-architecture-guide/) — A complete guide to building a HubSpot integration for AI agents and apps - OAuth scopes, write/upsert APIs, deduplication, Search API limits, and the build vs. buy decision. - [Connect HubSpot to Claude: Automate marketing blogs and support](https://truto.one/blog/connect-hubspot-to-claude-automate-marketing-blogs-and-support/) — Learn how to natively connect HubSpot to Claude using a managed MCP server. This guide covers setup, tool generation, and real-world AI automation workflows. - [Connect HubSpot to ChatGPT: Manage Sales Deals & Contact Records](https://truto.one/blog/connect-hubspot-to-chatgpt-manage-sales-deals-and-contact-records/) — Give your AI agents read and write access to HubSpot. Learn how to generate a secure MCP server, connect it to ChatGPT, and automate CRM workflows using natural language. - [Connect HubSpot to AI Agents: Sync invoices, orders, and workflows](https://truto.one/blog/connect-hubspot-to-ai-agents-sync-invoices-orders-and-workflows/) — Engineer's guide to connecting AI agents to Salesforce and HubSpot. Unified tool schemas, LangChain Python and Vercel AI SDK examples, idempotency, and approval gates.