Jobs, queues, and records in HubSpot without a second console.
Operate HubSpot from the same conversation as the hosts it runs on. Check jobs, queues, and interfaces without a second console; run diagnostic reports; and restart or update with the change previewed, approved, and logged.
262 tools: 112 read, 150 write. Reads answer instantly. Writes require approval by default. Everything is logged.
ReadAudit pipeline changes by idRetrieves 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…
ReadBatch read companies by propertiesBatch-retrieves up to 100 HubSpot company records by their IDs in a single request.
ReadFetch import error detailsFetches a paginated list of read-only error details for a specific HubSpot CRM import, requiring a valid `importId` for a processed import.
ReadFetch recording settings by app IDFetches call recording settings for a specified, existing HubSpot calling extension app.
ReadFetch revenueFetches 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…
ReadGet the variation of an A/B marketing emailRetrieves the alternate variation of a specified A/B marketing email; the `emailId` must identify an email currently in an A/B test.
ReadGet Account InformationGets current HubSpot account info (email, hubId, user details) using access-token lookup.
ReadGet active imports listRetrieves a list of currently active import jobs in HubSpot for monitoring ongoing data operations.
ReadGet aggregated statistic intervalsRetrieves aggregated statistics for marketing emails (e.g., send counts), grouped by specified time intervals within a defined time range.
ReadGet aggregated statisticsRetrieves aggregated statistics for marketing emails, optionally within an ISO8601 formatted time range, by email IDs, or specific email properties.
ReadGet all marketing emails for a HubSpot accountFetches a list of marketing emails from a HubSpot account, with options for filtering, sorting, pagination, and including performance statistics.
ReadGet blog postRetrieves one HubSpot CMS blog post by post ID.
ReadGet campaignRetrieves a HubSpot campaign by its ID.
ReadGet campaign metricsRetrieves key attribution metrics for an existing marketing campaign, identified by its `campaignGuid`, within an optional date range.
ReadGet companyRetrieves a HubSpot company by its ID.
ReadGet contact IDsFetches a list of contact IDs for a specific HubSpot campaign based on interaction type.
ReadGet CRM listRetrieves a HubSpot CRM list by its ILS list ID.
ReadGet dealRetrieves a HubSpot deal by its ID.
ReadGet dealsRetrieves multiple HubSpot deals by their IDs in a single batch request.
ReadGet emailsRetrieves multiple HubSpot email engagement records by their IDs in a single batch request.
ReadGet engagementRetrieve one legacy aggregate engagement by its engagement ID.
ReadGet specific event template for appRetrieves detailed information about a specific event template for a given application in HubSpot's CRM timeline.
ReadGet import record informationRetrieves 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…
ReadGet draft version of a marketing emailRetrieves the draft version of a marketing email by its `emailId`; if no draft exists, returns the published version.
ReadGet a revision of a marketing emailRetrieves a specific, previously saved revision of a marketing email using its unique email ID and revision ID.
ReadGet revisions of a marketing emailRetrieves 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.
ReadReturn pipeline by idRetrieves a specific pipeline by its ID and CRM object type, detailing its stages and properties.
ReadGet pipeline stage auditRetrieves a reverse chronological list of all mutations (changes) for a specific pipeline stage, including CREATE and UPDATE events with timestamps and details.
ReadGet productRetrieves a HubSpot product by its ID.
ReadGet productsRetrieves multiple HubSpot products by their IDs.
ReadGet quote by idRetrieves a specific HubSpot quote by its unique identifier.
ReadGet record list membershipsReturn the HubSpot lists that contain one CRM record.
ReadGet segment membersRetrieve segment (list) members ordered by join timestamp.
ReadGet the details of a specified marketing emailRetrieves detailed information for a specific marketing email in HubSpot using its unique email ID, optionally including performance statistics and specific properties.
ReadGet ticketRetrieves a HubSpot ticket by its ID.
ReadGet ticketsRetrieves multiple HubSpot tickets by their IDs.
ReadGet workflow by IDRetrieves comprehensive details for an existing HubSpot workflow by its unique ID; unsupported actions are designated 'UNSUPPORTED_ACTION' in the response.
ReadGet workflow revisionRetrieves a specific historical revision of a HubSpot workflow.
ReadGet all workflowsRetrieves a list of workflow summaries (ID, name, type, status) from HubSpot, using the 'limit' parameter for pagination.
ReadList assetsLists assets of a specific `assetType` for a given HubSpot marketing `campaignGuid`, optionally including performance metrics for a date range.
ReadList association typesLists all valid association types between two specified HubSpot CRM object types.
ReadList audit logsLists Enterprise-only HubSpot account audit logs with optional filters and pagination.
ReadList call dispositionsReturn HubSpot call disposition IDs and labels.
ReadList companiesRetrieves a paginated list of HubSpot companies.
ReadList company activitiesList all activity/engagement associations from a company to a specified activity type (calls, emails, meetings, notes, or tasks).
ReadList company callsLists all calls associated with a specific HubSpot company.
ReadList company meetingsList all meetings associated with a specific company in HubSpot.
ReadList contact notesList all notes associated with a specific HubSpot contact.
ReadList contact propertiesLists all contact properties in your HubSpot account, including custom properties you've created.
ReadList contactsRetrieves a paginated list of HubSpot contacts.
ReadList contact tasksList all tasks associated with a specific contact.
ReadList conversation threadsLists HubSpot conversation threads with filtering and forward pagination.
ReadList deal activitiesRetrieves activities (notes, calls, emails, meetings, tasks) associated with a specific HubSpot deal.
ReadList deal meetingsList all meetings associated with a specific deal in HubSpot.
ReadList dealsRetrieves a paginated list of HubSpot deals.
ReadList email eventsLists one page of HubSpot marketing email events; continue with `offset` only while `hasMore` is true.
ReadList EmailsRetrieves a paginated list of HubSpot emails, allowing selection of specific properties (with or without history), associated object IDs, and filtering by archive status.
ReadList all event templates for appRetrieves all event templates associated with a valid `appId` for an existing application in HubSpot's CRM Timeline.
ReadList feedback submissions pageRetrieves a paginated list of feedback submissions from HubSpot, allowing specification of properties (including history), associated object IDs, and filtering by archive status.
ReadList granted OAuth scopesIntrospect the current OAuth access token and return its granted scopes and metadata.
ReadList object associationsList all associations from a single CRM record to a specified target object type.
ReadList productsRetrieves a paginated list of HubSpot products.
ReadList quotes pageRetrieves a paginated list of quotes, allowing selection of specific properties, property history, associated object IDs, and filtering by archived status.
ReadList recently modified engagementsLists one page of engagements from HubSpot's last-30-days or 10,000-most-recently-updated feed.
ReadList sequencesLists automation sequences for a specific HubSpot user.
ReadList site pagesReturn one cursor-controlled page of HubSpot website pages.
ReadList ticketsRetrieves a paginated list of HubSpot tickets.
ReadRead a CRM property by nameReads a specific CRM property definition for a given HubSpot object type by its internal name.
ReadRead all properties for object typeRetrieves definitions and metadata (not actual values) for properties of a specified HubSpot CRM object type (e.g., 'contacts', 'companies', 'deals', or custom objects).
ReadRead a page of objects by typeRetrieves a paginated list of objects for a specified and valid HubSpot CRM object type (e.g., 'contacts', 'companies', 'deals', or custom ID).
ReadBatch read associationsBatch-read CRM associations (e.g., deals→contacts, deals→companies) for up to 1,000 source record IDs in one request.
ReadRead a batch of CRM object propertiesRetrieves property definitions (metadata) for a batch of CRM object properties for a specified object type.
ReadRead batch feedback submissions by id or propertyRetrieves up to 100 feedback submissions in a batch using their IDs or a specified unique `idProperty`, optionally including specified properties and their history.
ReadRead batch of crm objects by id or property valuesReads 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…
ReadRead batch of line items by id or property valuesRetrieves a batch of HubSpot CRM line items by their IDs, or optionally by values of a custom unique property defined in `idProperty`.
ReadRead batch of quotes by property valuesEfficiently retrieves a batch of HubSpot CRM quotes by their IDs (or a specified unique property), optionally including archived quotes, specific properties, and property history.
ReadRead budgetFetches detailed budget (total, spent, remaining) and spend information for a marketing campaign, including an 'order' field for sequencing budget/spend items (0 is oldest).
ReadRead contactRetrieves a HubSpot contact by its ID.
ReadRead contactsBatch read multiple HubSpot contacts by their IDs or custom identifier property.
ReadRead crm object by idRetrieves a specific CRM object (e.g., contact, company, deal, ticket) by its ID or a unique property, optionally including specific properties, history, and associations.
ReadReadEmail EmailCall this to retrieve an existing HubSpot email by its `emailId` or an alternative unique `idProperty`.
ReadRead feedback submission by idReads a HubSpot feedback submission by its ID, optionally using a custom unique 'idProperty', and allows specifying properties to return including history and associations.
ReadRead a property groupRetrieves 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.
ReadRead property groups for object typeRetrieves all property groups in a single call for a specified HubSpot CRM object type (e.g., 'contacts', 'companies'), returning only the groups themselves, not the individual properties within them.
ReadRender event detail templateRenders 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.
ReadRender event header or detail as htmlRenders 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.
ReadRetrieve all object schemasRetrieves all object schema definitions (not data records) for a HubSpot account, supporting retrieval of either active or archived schemas.
ReadRetrieve all pipelines for specified object typeRetrieves all pipelines in HubSpot for a specified CRM object type, such as deals or tickets.
ReadRetrieve calling settings for appRetrieves the read-only calling extension settings for a specific HubSpot app; the app must exist and have calling extensions configured.
ReadRetrieve line item by idRetrieves a HubSpot CRM line item by its ID or a specified unique property (`idProperty`).
ReadRetrieve line items listFetches 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…
ReadRetrieve existing object schemaFetches 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.
ReadRetrieve owner by ID or user IDRetrieves a specific HubSpot CRM owner by their ID, with options to specify ID type (owner or user) and to include archived records.
ReadRetrieve ownersRetrieves a list of all owners in the HubSpot CRM, including their ID, first name, last name, email, and user ID.
ReadRetrieve page of crm ownersRetrieves a paginated list of CRM owners from HubSpot, optionally filtering by email or archived status.
ReadRetrieve pipeline stage by idFetches detailed properties and metadata (e.g., label, display order, custom properties) for a specific stage within a HubSpot CRM pipeline, identified by its `objectType`, `pipelineId`, and…
ReadRetrieve pipeline stagesFetches all stages for a specified HubSpot CRM object type and pipeline ID.
ReadRetrieve timeline event by idsRetrieves 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.
ReadRetrieve video conference settings by idRetrieves video conference application settings, such as webhook URLs and user/account management configurations, for a specified `appId`.
ReadSearch campaignsSearches for HubSpot campaigns.
ReadSearch companiesSearches for HubSpot companies using flexible criteria and filters.
ReadSearch contacts by criteriaSearches 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.
ReadSearch crm objects by criteriaSearches HubSpot CRM objects (e.g., 'contacts', 'companies') by `objectType` using complex criteria including filters, sorting, and pagination; property names used in filters, sorts, and returned…
ReadSearch dealsSearches for HubSpot deals using flexible criteria and filters.
ReadSearch emailsSearches for HubSpot emails using flexible criteria and filters.
ReadSearch feedback submissionsSearches for feedback submissions in HubSpot CRM using text query, filter groups, sorting, and pagination, returning specified properties.
ReadSearch line items by criteriaSearches 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…
ReadSearch productsSearches for HubSpot products using flexible criteria and filters.
ReadSearch quotes by criteriaSearches HubSpot CRM quotes using a text query, complex filter criteria, sorting, and pagination.
ReadSearch ticketsSearches for HubSpot tickets using flexible criteria and filters.
ReadWho Am IReturn the connected HubSpot account (portal id, domain).
WriteAdd asset associationAssociates an existing asset ('FORM', 'OBJECT_LIST', or 'EXTERNAL_WEB_URL') with a specified HubSpot marketing campaign. Approval by default
WriteAdd token to event templateAdds 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. Approval by default
WriteArchive batch of feedback submissions by idAsynchronously 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… Approval by default
WriteArchive batch of line items by idArchives a batch of existing line items by their unique IDs in HubSpot CRM; this operation is irreversible via the API. Approval by default
WriteArchive batch of objects by idArchives a batch of existing, non-archived CRM objects of a specified `objectType` by their IDs, effectively hiding them from active use. Approval by default
WriteArchive batch of propertiesArchives a batch of properties by their internal names for a specified HubSpot CRM object type; this operation is idempotent and safe to retry. Approval by default
WriteArchive a batch of quotes by idArchives 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… Approval by default
WriteArchive companiesArchives multiple HubSpot companies by their IDs. Approval by default
WriteArchive companyArchives 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. Approval by default
WriteArchive contactArchives a HubSpot contact by its ID. Approval by default
WriteArchive contactsArchives multiple HubSpot contacts by their IDs. Approval by default
WriteArchive a CRM object by IDArchives 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. Approval by default
WriteArchive dealsArchives multiple HubSpot deals by their IDs. Approval by default
WriteArchiveEmail emailArchives the HubSpot email specified by `emailId` by moving it to the recycling bin, making it inaccessible unless restored. Approval by default
WriteArchive emailsArchives multiple HubSpot emails by their IDs. Approval by default
WriteArchive feedback submissionArchives an existing, non-archived Feedback Submission in HubSpot CRM by its ID, moving it to the recycling bin (not permanently deleting it). Approval by default
WriteArchive line item by idArchives a specific HubSpot line item by its ID, moving it to a recoverable state. Approval by default
WriteArchive productArchives a HubSpot product by its ID. Approval by default
WriteArchive productsArchives multiple HubSpot products by their IDs. Approval by default
WriteArchive property by object type and nameArchives 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. Approval by default
WriteArchive property groupArchives a HubSpot property group, making it inactive and hidden (not permanently deleted, allowing potential restoration) with immediate effect on its CRM visibility and usability. Approval by default
WriteArchive quote object by idArchives a HubSpot Quote object by ID, moving it to the recycling bin where it can be restored within 90 days. Approval by default
WriteArchive ticketArchives a HubSpot ticket by its ID. Approval by default
WriteArchive ticketsArchives multiple HubSpot tickets by their IDs. Approval by default
WriteBatch update quotesUpdates 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. Approval by default
WriteCancel active importCancels an active HubSpot data import job using its `importId`; this action is irreversible, and any data already processed will remain. Approval by default
WriteClone marketing emailDuplicates an existing HubSpot marketing email, identified by its `id`, into a new draft; an optional `cloneName` can be assigned to this new email copy. Approval by default
WriteConfigure calling extension settingsConfigures 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`. Approval by default
WriteCreate A/B test variationCreates 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. Approval by default
WriteCreate a new property groupCreates 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. Approval by default
WriteCreate a new marketing emailCreates 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`… Approval by default
WriteCreate association for object typeCreates 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… Approval by default
WriteCreate batch of feedback submissionsCreates 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. Approval by default
WriteCreate batch of objectsCreates multiple CRM objects of a specified `objectType` (e.g., contacts, companies, deals) in a single batch operation, where each object can have its own set of properties and associations. Approval by default
WriteCreate batch of propertiesEfficiently creates multiple CRM properties in a single batch for a specified HubSpot object type (e.g., 'contacts', 'companies', custom object ID), ideal for schema setup or updates. Approval by default
WriteCreate batch of quotesCreates 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… Approval by default
WriteCreate campaignCreates a new HubSpot campaign. Approval by default
WriteCreate campaignsCreates multiple HubSpot campaigns by calling the single campaign creation endpoint for each campaign. Approval by default
WriteCreate companiesCreates multiple new HubSpot companies in a single batch operation. Approval by default
WriteCreate companyCreates a new HubSpot company. Approval by default
WriteCreate contactCreates a new HubSpot contact. Approval by default
WriteCreate Contact From Natural LanguageCreates a new contact in HubSpot from a natural language description. Approval by default
WriteCreate contactsCreates multiple new HubSpot contacts in a single batch operation. Approval by default
WriteCreate CRM Object From Natural LanguageCreates a new CRM object (contact, deal, company, ticket, or custom object) in HubSpot from a natural language description. Approval by default
WriteCreate CRM object with propertiesCreates a new HubSpot CRM object (e.g., contact, company, custom object) with specified `properties` (using valid internal names) and `associations` (to existing objects via valid type IDs). Approval by default
WriteCreate dealCreates a new HubSpot deal. Approval by default
WriteCreate Deal From Natural LanguageCreates a new deal in HubSpot from a natural language description. Approval by default
WriteCreate dealsCreates multiple deals in HubSpot CRM; ensure any associated object IDs, deal stages, and pipeline IDs specified are valid and exist within the HubSpot account. Approval by default
WriteCreate emailCreates a new HubSpot email engagement record. Approval by default
WriteCreate emailsCreates multiple HubSpot emails in a single batch operation. Approval by default
WriteCreate engagementCreate a legacy EMAIL, CALL, MEETING, TASK, or NOTE engagement with optional CRM associations, attachments, and type-specific metadata. Approval by default
WriteCreate event template for appCreates 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… Approval by default
WriteCreate feedback submissionCreates a new HubSpot feedback submission to record customer feedback (e.g., survey responses, support interactions), optionally associating it with CRM objects. Approval by default
WriteCreate line itemCreates a new HubSpot line item. Approval by default
WriteCreate line itemsCreates multiple HubSpot line items in a single batch operation. Approval by default
WriteCreate listCreate a HubSpot CRM list with manual, snapshot, or dynamic membership rules. Approval by default
WriteCreate meetingCreates a new meeting engagement in HubSpot CRM. Approval by default
WriteCreate noteCreates a new HubSpot CRM note. Approval by default
WriteCreate object associationCreate or label an association between two CRM records using HubSpot Associations v4 API. Approval by default
WriteCreate new object schema with custom propertiesCreates 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… Approval by default
WriteCreate or update draft versionCreates 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… Approval by default
WriteCreate pipeline for object typeCreates a new HubSpot pipeline for a specified CRM `objectType` (e.g., 'deals', 'tickets'), requiring the pipeline `label` be unique for that `objectType` and each stage `label` be unique within the… Approval by default
WriteCreate pipeline stageCreates a new stage in a specified HubSpot CRM pipeline for a given object type, such as 'deals' or 'tickets'. Approval by default
WriteCreate productCreates a new HubSpot product. Approval by default
WriteCreate productsCreates multiple HubSpot products in a single batch operation. Approval by default
WriteCreate property for specified object typeCreates a new custom property for a specified HubSpot CRM object type; ensure `groupName` refers to an existing property group for the `objectType`. Approval by default
WriteCreate quote objectCreates a new quote object in HubSpot CRM with specified properties and associations. Approval by default
WriteCreate taskCreates a new CRM task record. Approval by default
WriteCreate ticketCreates a new HubSpot ticket. Approval by default
WriteCreate ticketsCreates 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… Approval by default
WriteCreate timeline event based on templateCreates 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… Approval by default
WriteCreate multiple timeline events batchCreates 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… Approval by default
WriteCreate workflowCreates a new HubSpot workflow to automate processes; ensure `enrollmentCriteria` and `actions` use properties relevant to the specified `objectTypeId`. Approval by default
WriteDelete callPermanently deletes a HubSpot call record by its ID. Approval by default
WriteDelete calling extension settingsPermanently deletes the settings for a calling extension app, specified by its `appId`, rendering it unusable for all connected HubSpot accounts; this operation is irreversible. Approval by default
WriteDelete campaignPermanently deletes a marketing campaign from HubSpot using its `campaignGuid`; returns a 204 No Content status even if the campaign does not exist. Approval by default
WriteArchive a batch of campaignsArchives a batch of up to 50 marketing campaigns, hiding them from active views rather than permanently deleting them. Approval by default
WritePermanently delete company for GDPR compliancePermanently 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. Approval by default
WritePermanently delete contact for GDPR complianceIrreversibly erases a HubSpot contact and associated data per a GDPR request; if an email is given for a non-existent contact, it's blocklisted. Approval by default
WriteArchive deal (GDPR permanent delete not supported for deals)Archives a HubSpot deal by its ID. Approval by default
WritePermanently delete line items for gdprPermanently deletes a specified line item and its associated content for GDPR compliance; this action is irreversible and cannot be undone. Approval by default
WriteDelete a marketing emailPermanently deletes a marketing email from your HubSpot account. Approval by default
WriteDelete meetingPermanently deletes (archives) a HubSpot meeting by its ID, moving it to the recycling bin where it can be restored within 90 days. Approval by default
WriteDelete noteArchives a HubSpot note by its ID, removing it from active view. Approval by default
WriteDelete pipeline by idPermanently 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. Approval by default
WriteDelete pipeline stage by idPermanently deletes a specific pipeline stage for an `objectType` (e.g., 'deals', 'tickets') that supports pipelines; this operation is irreversible, so ensure no active CRM records are associated… Approval by default
WriteDelete schema by object typeDeletes a HubSpot custom object schema by `objectType`. Approval by default
WriteDelete taskArchives a HubSpot task by its ID, removing it from active task lists. Approval by default
WriteDelete timeline event templatePermanently and irreversibly deletes a specific timeline event template, identified by its `eventTemplateId`, from the application `appId`. Approval by default
WriteDelete video conferencing app settingsIrreversibly deletes all settings for a video conferencing application identified by its `appId` in HubSpot, removing its configuration and preventing it from functioning until reconfigured… Approval by default
WriteDelete workflowPermanently deletes a HubSpot workflow by its ID; deleted workflows cannot be restored via the API and the ID must exist. Approval by default
WriteEnroll contact in workflowEnrolls a contact, identified by email, in a HubSpot workflow. Approval by default
WriteMerge two companies of same typeMerges two existing company records of the same type in HubSpot CRM, where `objectIdToMerge` is absorbed into `primaryObjectId`; this operation is irreversible. Approval by default
WriteMerge contactsMerges two HubSpot contacts into one. Approval by default
WriteMerge dealsMerges two HubSpot deals into one. Approval by default
WriteMerge emailsMerges two HubSpot emails into one. Approval by default
WriteMerge two feedback submissionsMerges two existing feedback submissions by ID, primarily for consolidating duplicates or related feedback; this operation is irreversible, and `primaryObjectId` values take precedence in conflicts. Approval by default
WriteMerge two line items of same typeMerges two line items, `objectIdToMerge` into `primaryObjectId`, which must be of the same type; `objectIdToMerge` is absorbed and the operation is irreversible. Approval by default
WriteMerge two objects of same typeMerges two distinct HubSpot CRM objects of the same `objectType`, consolidating data into `primaryObjectId` (which is preserved) and deleting `objectIdToMerge`; this operation is permanent and… Approval by default
WriteMerge productsMerges two HubSpot products into one. Approval by default
WriteMerge two quotes of same typeMerges two distinct quotes of the same type by consolidating `objectIdToMerge` into `primaryObjectId` (e.g., for combining information or updating terms); this operation is irreversible. Approval by default
WriteMerge ticketsMerges two HubSpot tickets into one. Approval by default
WritePartially update CRM object by IDPartially updates specified properties of a CRM object (e.g., contact, company, deal) identified by its type and ID, or optionally by a unique property value if `idProperty` is specified. Approval by default
WritePermanently delete contact via GDPRPermanently deletes a HubSpot contact and all its associated data for GDPR compliance, identifying the contact by its ID or another unique property. Approval by default
WritePublish or send a marketing emailPublishes or sends a specified HubSpot marketing email that is valid and ready for sending; requires Marketing Hub Enterprise or the transactional email add-on. Approval by default
WriteRemove asset associationDisassociates an asset from a HubSpot marketing campaign. Approval by default
WriteRemove association between CRM recordsRemove all associations between two CRM records using the v4 associations endpoint. Approval by default
WriteRemove association from schemaPermanently removes a specified association definition (type) from a HubSpot object's schema, preventing future creations of this association type without affecting existing instances. Approval by default
WriteRemove dealRemoves a HubSpot deal by its ID. Approval by default
WriteRemove token from event templateRemoves a token from a HubSpot event template, preventing its inclusion in new events created from that template. Approval by default
WriteReplace all properties of pipelineOverwrites an entire CRM pipeline (specified by `objectType` and `pipelineId`) and all its stages with a new definition, returning the updated pipeline. Approval by default
WriteReplace pipeline stage propertiesReplaces 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. Approval by default
WriteReset draftResets 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. Approval by default
WriteRestore a revision of a marketing email to draft stateRestores a specific revision of a marketing email to a DRAFT state, overwriting any existing draft. Approval by default
WriteRestore a revision of a marketing emailRestores a specific, existing, non-active revision of a marketing email to become the new live version for that email. Approval by default
WriteSet call recording settingsConfigures the URL (`urlToRetrieveAuthedRecording`) that HubSpot uses to retrieve call recordings for a specified third-party calling app (`appId`). Approval by default
WriteInitiate data import processCall 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… Approval by default
WriteUpdate a marketing emailUpdates properties of an existing marketing email identified by its `emailId`; unspecified fields retain their current values. Approval by default
WriteUpdate batch feedback submissionsUpdates a batch of HubSpot feedback submissions; property keys must be existing internal HubSpot names and values must be correctly formatted strings. Approval by default
WriteUpdate a batch of objects by id or property valuesPerforms a batch update on a valid `objectType` where properties are writeable and any `idProperty` used is designated unique; updates can be partial. Approval by default
WriteUpdate calling app recording settingsUpdates the recording settings, such as the URL for retrieving authenticated recordings, for a specific calling extension app identified by its `appId`. Approval by default
WriteModify calling extension settingsUpdates settings (e.g., display name, UI URL/dimensions, feature flags) for an existing calling extension app, identified by `appId`. Approval by default
WriteUpdate campaignPartially updates specific, writable properties of an existing HubSpot marketing campaign identified by `campaignGuid`; an empty string value in `properties` clears a property. Approval by default
WriteUpdate a batch of campaignsUpdates properties for up to 50 existing HubSpot marketing campaigns in a single batch operation. Approval by default
WriteUpdate companiesUpdates multiple HubSpot companies in a single batch operation. Approval by default
WriteUpdate companyUpdates properties for an existing HubSpot company. Approval by default
WriteUpdate contactUpdates properties for an existing HubSpot contact. Approval by default
WriteUpdate contactsUpdates multiple HubSpot contacts in a single batch operation. Approval by default
WriteUpdate specific CRM propertyUpdates 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… Approval by default
WriteUpdate dealUpdates properties for an existing HubSpot deal. Approval by default
WriteUpdate dealsUpdates multiple HubSpot deals in a single batch operation. Approval by default
WriteUpdateEmail EmailPartially 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. Approval by default
WriteUpdate emailsUpdates multiple HubSpot emails in a single batch operation. Approval by default
WriteUpdate existing event templateUpdates 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`… Approval by default
WriteUpdate feedback submission by idPartially 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… Approval by default
WriteUpdate line item object partiallyPartially 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… Approval by default
WriteUpdate a batch of line itemsUpdates 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… Approval by default
WriteUpdate existing object schemaUpdates 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… Approval by default
WritePartially update pipeline by idPartially updates a CRM pipeline's label, display order, or restores an archived pipeline by setting `archived` to `false`. Approval by default
WriteUpdate pipeline stage by idsPartially updates a HubSpot CRM pipeline stage identified by `objectType`, `pipelineId`, and `stageId`, requiring `metadata` in the request; unspecified fields are unchanged. Approval by default
WriteUpdate productUpdates properties for an existing HubSpot product. Approval by default
WriteUpdate productsUpdates multiple HubSpot products in a single batch operation. Approval by default
WritePartially update property groupPartially updates a property group's `displayOrder` or `label` for a specified CRM `objectType` in HubSpot. Approval by default
WritePartial update quote by quote idPerforms 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… Approval by default
WriteUpdate ticketUpdates properties for an existing HubSpot ticket. Approval by default
WriteUpdate ticketsUpdates multiple HubSpot tickets in a single batch operation. Approval by default
WriteUpdate token on event templateUpdates the label or options of an existing token within a specified HubSpot CRM event template; token name and data type remain unchanged. Approval by default
WriteUpdate video conference app settingsUpdates webhook URLs (for creating/updating/deleting meetings, fetching accounts, verifying users) for a video conference application specified by `appId`. Approval by default
WriteUpdate workflowFully replace an existing Automation v4 workflow at its current revision. Approval by default
WriteUpsert contactsCreates or updates as many as 100 HubSpot contacts by unique property value. Approval by default
One prompt, start to finish
What a governed HubSpot run looks like inside Luumen.
Questions
How does LuumenAI connect to HubSpot?
Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.
Can LuumenAI change things in HubSpot on its own?
Read actions answer immediately. Anything that writes — add asset association, add token to event template, archive batch of feedback submissions by id, archive batch of line items by id, and more — is shown as a plan and requires approval by default, including the 58 actions classified as destructive. Administrators configure that per tool, so you decide exactly which actions can ever run unattended.
Who gets access to the integration?
You decide. Actions are granted per agent, skill, and team, and per environment — production is not staging. Read access can be broad while writes stay narrow.
Is there an audit trail?
Every call to HubSpot — read or write, approved or declined — is recorded with the actor, the input, and the result, and can be linked to the ticket or change record.