How to integrate Hubspot MCP with Hermes

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

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

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

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

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

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

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

Archives multiple HubSpot companies by their IDs.

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

Archives a HubSpot contact by its ID.

Archives multiple HubSpot contacts by their IDs.

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

Archives multiple HubSpot deals by their IDs.

Archives the HubSpot email specified by `emailId` by moving it to the recycling bin, making it inaccessible unless restored.

Archives multiple HubSpot emails by their IDs.

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

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

Archives a HubSpot product by its ID.

Archives multiple HubSpot products by their IDs.

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

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

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

Archives a HubSpot ticket by its ID.

Archives multiple HubSpot tickets by their IDs.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Creates a new HubSpot campaign.

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

Creates multiple new HubSpot companies in a single batch operation.

Creates a new HubSpot company.

Creates a new HubSpot contact.

Creates a new contact in HubSpot from a natural language description.

Creates multiple new HubSpot contacts in a single batch operation.

Creates a new CRM object (contact, deal, company, ticket, or custom object) in HubSpot from a natural language description.

Creates a new HubSpot CRM object (e.

Creates a new HubSpot deal.

Creates a new deal in HubSpot from a natural language description.

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

Creates a new HubSpot email engagement record.

Creates multiple HubSpot emails in a single batch operation.

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

Creates a new HubSpot feedback submission to record customer feedback (e.

Creates a new HubSpot line item.

Creates multiple HubSpot line items in a single batch operation.

Creates a new HubSpot CRM note.

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

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

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

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

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

Creates a new HubSpot product.

Creates multiple HubSpot products in a single batch operation.

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

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

Creates a new CRM task record.

Creates a new HubSpot ticket.

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

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

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

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

Permanently deletes the settings for a calling extension app, specified by its `appId`, rendering it unusable for all connected HubSpot accounts; this operation is irreversible.

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

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

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

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

Archives a HubSpot deal by its ID.

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

Permanently deletes a marketing email from your HubSpot account.

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

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

Deletes a HubSpot custom object schema by `objectType`.

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

Irreversibly deletes all settings for a video conferencing application identified by its `appId` in HubSpot, removing its configuration and preventing it from functioning until reconfigured; existing meetings and historical data are unaffected.

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

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

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

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

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

Gets current HubSpot account info (email, hubId, user details) using access-token lookup.

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

Retrieves aggregated statistics for marketing emails (e.

Retrieves aggregated statistics for marketing emails, optionally within an ISO8601 formatted time range, by email IDs, or specific email properties.

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

Retrieves a HubSpot campaign by its ID.

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

Retrieves multiple HubSpot campaigns.

Retrieves a HubSpot company by its ID.

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

Retrieves a HubSpot deal by its ID.

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

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

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

Retrieves a comprehensive summary of a specific HubSpot CRM import record by its `importId`, including status, progress, updates, results, and errors; useful for monitoring and troubleshooting data imports.

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

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

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

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

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

Retrieves a HubSpot product by its ID.

Retrieves multiple HubSpot products by their IDs.

Retrieves a specific HubSpot quote by its unique identifier.

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

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

Retrieves a HubSpot ticket by its ID.

Retrieves multiple HubSpot tickets by their IDs.

Retrieves comprehensive details for an existing HubSpot workflow by its unique ID; unsupported actions are designated 'UNSUPPORTED_ACTION' in the response.

Retrieves a list of workflow summaries (ID, name, type, status) from HubSpot, using the 'limit' parameter for pagination.

Lists assets of a specific `assetType` for a given HubSpot marketing `campaignGuid`, optionally including performance metrics for a date range.

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

Retrieves a paginated list of HubSpot companies.

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

Retrieves a paginated list of HubSpot contacts.

Retrieves a paginated list of HubSpot deals.

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

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

Retrieves a paginated list of feedback submissions from HubSpot, allowing specification of properties (including history), associated object IDs, and filtering by archive status.

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

List all associations from a single CRM record to a specified target object type.

Retrieves a paginated list of HubSpot products.

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

Retrieves a paginated list of HubSpot tickets.

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

Merges two HubSpot contacts into one.

Merges two HubSpot deals into one.

Merges two HubSpot emails into one.

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

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

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

Merges two HubSpot products into one.

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

Merges two HubSpot tickets into one.

Partially updates specified properties of a CRM object (e.

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

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

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

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

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

Tool to batch-read CRM associations (e.

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

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

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

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

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

Fetches detailed budget (total, spent, remaining) and spend information for a marketing campaign, including an 'order' field for sequencing budget/spend items (0 is oldest).

Retrieves a HubSpot contact by its ID.

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

Retrieves a specific CRM object (e.

Call this to retrieve an existing HubSpot email by its `emailId` or an alternative unique `idProperty`.

Reads a HubSpot feedback submission by its ID, optionally using a custom unique 'idProperty', and allows specifying properties to return including history and associations.

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

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

Disassociates an asset from a HubSpot marketing campaign.

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

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

Removes a HubSpot deal by its ID.

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

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

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

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

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

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

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

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

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

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

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

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

Fetches a paginated list of HubSpot CRM line items, allowing selection of specific properties (including history), associated object IDs, and filtering by archive status; ensure property and association names are valid HubSpot internal names.

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

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

Retrieves a list of all owners in the HubSpot CRM, including their ID, first name, last name, email, and user ID.

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

Fetches detailed properties and metadata (e.

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

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

Retrieves video conference application settings, such as webhook URLs and user/account management configurations, for a specified `appId`.

Searches for HubSpot campaigns.

Searches for HubSpot companies using flexible criteria and filters.

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

Searches HubSpot CRM objects (e.

Searches for HubSpot deals using flexible criteria and filters.

Searches for HubSpot emails using flexible criteria and filters.

Searches for feedback submissions in HubSpot CRM using text query, filter groups, sorting, and pagination, returning specified properties.

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

Searches for HubSpot products using flexible criteria and filters.

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

Searches for HubSpot tickets using flexible criteria and filters.

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

Call this action to start an asynchronous data import into HubSpot CRM using uploaded files and a detailed `importRequest` JSON configuration, ensuring this JSON correctly maps file columns to HubSpot properties and files align with these mappings.

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

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

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

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

Updates settings (e.

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

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

Updates multiple HubSpot companies in a single batch operation.

Updates properties for an existing HubSpot company.

Updates properties for an existing HubSpot contact.

Updates multiple HubSpot contacts in a single batch operation.

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

Updates properties for an existing HubSpot deal.

Updates multiple HubSpot deals in a single batch operation.

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

Updates multiple HubSpot emails in a single batch operation.

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

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

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

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

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

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

Partially updates a HubSpot CRM pipeline stage identified by `objectType`, `pipelineId`, and `stageId`, requiring `metadata` in the request; unspecified fields are unchanged.

Updates properties for an existing HubSpot product.

Updates multiple HubSpot products in a single batch operation.

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

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

Updates properties for an existing HubSpot ticket.

Updates multiple HubSpot tickets in a single batch operation.

Updates the label or options of an existing token within a specified HubSpot CRM event template; token name and data type remain unchanged.

Updates webhook URLs (for creating/updating/deleting meetings, fetching accounts, verifying users) for a video conference application specified by `appId`.