Your AI team, working in HubSpot

HubSpot is an inbound marketing, sales, and customer service platform integrating CRM, email automation, and analytics to facilitate lead nurturing and seamless customer experiences

Start your company

What your team can do in HubSpot

355 tools to work with, connected with your account.

Add asset association

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

Add token to event template

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.

Archive a batch of campaigns

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

Archive a batch of quotes by id

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.

Archive a CRM object by ID

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.

Archive batch of feedback submissions by id

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.

Archive batch of line items by id

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

Archive batch of objects by id

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

Archive batch of properties

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

Archive companies

Archives multiple HubSpot companies by their IDs.

Archive company

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.

Archive contact

Archives a HubSpot contact by its ID.

Archive contacts

Archives multiple HubSpot contacts by their IDs.

Archive deal (GDPR permanent delete not supported for deals)

Archives a HubSpot deal by its ID. Note: HubSpot's GDPR permanent deletion API only supports contacts, not deals. This action archives the deal (moves to recycling bin for 90 days) as the closest available functionality.

Archive deals

Archives multiple HubSpot deals by their IDs.

Archive emails

Archives multiple HubSpot CRM email engagement records by their IDs.

Archive feedback submission

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

Archive line item by id

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

Archive product

Archives a HubSpot product by its ID.

Archive products

Archives multiple HubSpot products by their IDs.

Archive property by object type and name

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.

Archive property group

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.

Archive quote object by id

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

Archive ticket

Archives a HubSpot ticket by its ID.

Archive tickets

Archives multiple HubSpot tickets by their IDs.

ArchiveEmail email

Archives a HubSpot CRM email engagement by its numeric object ID, moving it to the recycling bin.

Audit pipeline changes by idReads only

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.g., 'deals', 'tickets').

Batch archive association labels

Remove selected labels from up to 100 HubSpot CRM association pairs. Removing a default unlabeled association also removes every label between that record pair.

Batch archive associations

Remove all associations for grouped HubSpot CRM record sets without archiving their records.

Batch create contact-company associations

Creates up to 2,000 labeled contact-to-company associations.

Batch create deal-company associations

Creates labeled associations from deals to companies in one batch.

Batch create default associations

Create default unlabeled associations for batches of HubSpot CRM record pairs.

Batch read associationsReads only

Tool to batch-read CRM associations (e.g., deals→contacts, deals→companies) for up to 1,000 source record IDs in one request. Use when you need to retrieve associated target IDs and association type metadata for multiple records efficiently, avoiding rate-limit issues from per-record GET calls.

Batch read companies by propertiesReads only

Batch-retrieves up to 100 HubSpot company records by their IDs in a single request. Supports custom ID properties (e.g., domain), selective property retrieval, and historical property values.

Batch read list membershipsReads only

Retrieve list memberships for multiple HubSpot CRM records.

Batch read workflow ID mappingsReads only

Resolves current flow IDs and legacy workflow IDs in one batch.

Batch read workflowsReads only

Retrieves multiple HubSpot automation workflows by flow ID.

Batch update quotes

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.

Cancel active import

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

Clone marketing email

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.

Configure calling extension settings

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`.

Create a new marketing email

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.

Create a new property group

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.

Create A/B test variation

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. This action only creates the variation—it does not start the A/B test or send emails. Note: If an active variation already exists for the email, a new one will not be created. Requires Marketing Hub Professional or Enterprise subscription.

Create association for object type

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. Note: This endpoint requires crm.schemas.custom.write scope and only works with custom objects (not standard HubSpot objects like contacts or companies).

Create association label

Create a custom relationship-label definition between two CRM object types.

Create batch of feedback submissions

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.

Create batch of objects

Creates 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.

Create batch of properties

Efficiently 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.

Create batch of quotes

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.

Create blog post

Create a HubSpot CMS blog post, defaulting to a draft.

Create campaign

Creates a new HubSpot campaign.

Create campaign spend item

Records a spend item against a HubSpot marketing campaign.

Create campaigns

Creates multiple HubSpot campaigns by calling the single campaign creation endpoint for each campaign. Note: HubSpot does not provide a native batch create endpoint for campaigns. This action creates multiple campaigns by making individual API calls for each campaign in the batch.

Create companies

Creates multiple new HubSpot companies in a single batch operation.

Create company

Creates a new HubSpot company.

Create contact

Creates a new HubSpot contact.

Create Contact From Natural Language

Creates a HubSpot contact from a natural language description, using the contact property schema and an LLM-generated property payload. Requires an OpenAI API key and can include supplied associations.

Create contacts

Creates multiple HubSpot contacts in a batch, with contact properties and optional associations to existing CRM records. Custom properties should use the internal names of properties already defined in the account.

Create content template

Create a HubSpot Design Manager template from HubL or HTML source.

Create CRM Object From Natural Language

Creates a HubSpot CRM record from a natural-language description, including contacts, deals, companies, tickets, and custom objects. Optional associations can link the new record to other CRM objects.

Create CRM object with properties

Creates 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).

Create deal

Creates a new HubSpot deal.

Create Deal From Natural Language

Creates a HubSpot deal from a natural language description using an LLM and the deal property schema. It attempts to fetch pipeline stages for context and accepts an optional pipeline override and associations.

Create deals

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.

Create default association

Create HubSpot's default unlabeled association between two CRM records.

Create email

Creates a new HubSpot email engagement record. REQUIRED FIELDS in properties dict: - hs_email_subject: Subject line - hs_email_html: HTML content - hs_timestamp: Unix timestamp in milliseconds - hs_email_direction: One of 'EMAIL', 'INCOMING_EMAIL', 'FORWARDED_EMAIL', 'DRAFT_EMAIL' This creates an email engagement/activity record in HubSpot CRM, not a marketing email.

Create emails

Creates multiple HubSpot CRM email engagement records in a single batch operation using supplied email properties.

Create engagement

Create a legacy EMAIL, CALL, MEETING, TASK, or NOTE engagement with optional CRM associations, attachments, and type-specific metadata.

Create event template for app

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.

Create feedback submission

Creates a HubSpot feedback submission with properties and an associations list, which may be empty.

Create landing page

Create a HubSpot landing page, as a draft unless state is explicitly set.

Create line item

Creates a new HubSpot line item.

Create line items

Creates multiple HubSpot line items in a single batch operation.

Create list

Create a HubSpot CRM list with manual, snapshot, or dynamic membership rules.

Create meeting

Creates a new meeting engagement in HubSpot CRM. Use this action when you need to log a meeting that occurred or schedule a future meeting with contacts, companies, or other CRM records. The meeting will appear on the timeline of associated records and can include details like title, time, location, notes, and outcome.

Create multiple timeline events batch

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.

Create new object schema with custom properties

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).

Create note

Creates a new HubSpot CRM note. Use when you need to add a timestamped note with optional attachments and associations to contacts, companies, deals, or tickets.

Create object association

Tool to create or label an association between two CRM records using HubSpot Associations v4 API. Use when you need to link records (e.g., contact to company, deal to contact) with explicit association labels.

Create or update draft version

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.

Create pipeline for object type

Creates 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 pipeline.

Create pipeline stage

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

Create product

Creates a new HubSpot product. Note: Products are catalog items and cannot be directly associated with deals, contacts, or companies. To connect product information to a deal or quote, create a line item using HUBSPOT_CREATE_LINE_ITEM that references this product's ID via hs_product_id.

Create products

Creates multiple HubSpot products in a single batch operation.

Create property for specified object type

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

Create quote object

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

Create site page

Create a HubSpot website page draft and return its complete page record.

Create task

Creates a new CRM task record. Use when adding a task with properties and optional associations.

Create ticket

Creates a new HubSpot ticket.

Create tickets

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.

Create timeline event based on template

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.

Create workflow

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

Delete a marketing email

Permanently deletes a marketing email from your HubSpot account. This action cannot be undone.

Delete association label

Delete one custom relationship-label definition between CRM object types.

Delete call

Deletes a HubSpot call record by its ID. The action returns error details in its response when the delete request fails.

Delete calling extension settings

Deletes the settings for a calling extension app identified by its app ID. The action returns error details in its response when the delete request fails.

Delete campaign

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

Delete CRM list

Soft-deletes a HubSpot CRM list by its ILS list ID.

Delete meeting

Permanently deletes (archives) a HubSpot meeting by its ID, moving it to the recycling bin where it can be restored within 90 days. Use this action when you need to remove a meeting engagement from HubSpot's CRM. This action is irreversible via the API — the meeting cannot be recovered programmatically once deleted.

Delete note

Archives a HubSpot note by its ID, removing it from active view. The note is archived rather than permanently deleted and can be restored within 90 days. Use this action when you need to remove a note from the CRM without permanently deleting it. This action is irreversible through the API - archived notes cannot be restored programmatically.

Delete pipeline by id

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.

Delete pipeline stage by id

Permanently 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 with the stage to prevent data issues.

Delete schema by object type

Deletes a HubSpot custom object schema by `objectType`. With `archived=false` (default), it archives the schema (soft delete). With `archived=true`, it permanently deletes an already-archived schema (hard delete). Prerequisites: All object instances, associations, and properties must be deleted first.

Delete task

Archives a HubSpot task by its ID, removing it from active task lists. Use this action when you need to delete or remove a task from HubSpot CRM. The task is archived rather than permanently deleted and may be recoverable. This action is irreversible from the API perspective — the task cannot be directly unarchived via this action.

Delete timeline event template

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

Delete video conferencing app settings

Deletes the settings for a specified HubSpot video conferencing application.

Delete workflow

Permanently deletes a HubSpot workflow by its ID; deleted workflows cannot be restored via the API and the ID must exist. API error responses are returned in the result.

Download CMS source fileReads only

Download one file from HubSpot's CMS developer filesystem.

Enroll contact in sequence

Enrolls an existing HubSpot contact in an automation sequence.

Enroll contact in workflow

Enrolls a contact, identified by email, in a HubSpot workflow.

Fetch import error detailsReads only

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

Fetch recording settings by app IDReads only

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

Fetch revenueReads only

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`.

Get a revision of a marketing emailReads only

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

Get Account InformationReads only

Retrieves current HubSpot account details, including the account ID, time zone, currencies, UI domain and data hosting location.

Get active imports listReads only

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

Get aggregated statistic intervalsReads only

Retrieves aggregated statistics for marketing emails (e.g., send counts), grouped by specified time intervals within a defined time range.

Get aggregated statisticsReads only

Retrieves aggregated marketing email statistics for a time range, with optional email ID and property parameters. Missing start and end timestamps default to 30 days ago and the current time, respectively.

Get all marketing emails for a HubSpot accountReads only

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

Get all workflowsReads only

Retrieves workflow summaries from HubSpot in a single request, applying the limit locally to the returned list.

Get blog postReads only

Retrieves one HubSpot CMS blog post by post ID.

Get blog settingsReads only

Retrieves one HubSpot CMS blog's settings by blog ID.

Get blog tagReads only

Retrieves one HubSpot CMS blog tag by tag ID.

Get campaignReads only

Retrieves a HubSpot campaign by its ID.

Get campaign metricsReads only

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

Get campaignsReads only

Retrieves multiple HubSpot campaigns.

Get CMS source metadataReads only

Retrieves metadata for one HubSpot CMS source path.

Get communication statusReads only

Retrieves detailed HubSpot communication statuses for an email address.

Get companyReads only

Retrieves a HubSpot company by its ID.

Get contact IDsReads only

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

Get contact sequence enrollmentReads only

Return a contact's active sequence enrollment; HubSpot returns 404 when none exists.

Get contact workflow enrollmentsReads only

Return the workflows in which a HubSpot contact is currently enrolled.

Get CRM export statusReads only

Retrieves the status and available result of a HubSpot CRM export task.

Get CRM listReads only

Retrieves a HubSpot CRM list by its ILS list ID.

Get CRM list by nameReads only

Retrieves a HubSpot CRM list by object type and exact name.

Get CRM lists by IDsReads only

Retrieves multiple HubSpot CRM lists by their current IDs.

Get dealReads only

Retrieves a HubSpot deal by its ID.

Get dealsReads only

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

Get draft version of a marketing emailReads only

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

Get email subscription statusReads only

Retrieves legacy overall email delivery and subscription state for an address.

Get emailsReads only

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

Get engagementReads only

Retrieve one legacy aggregate engagement by its engagement ID.

Get exchange rateReads only

Retrieves one HubSpot account exchange rate by ID.

Get fileReads only

Retrieves one HubSpot file-manager record by file ID.

Get file import statusReads only

Retrieves the status and result of a HubSpot URL file import task.

Get file signed URLReads only

Generates a temporary signed URL for one HubSpot file.

Get formReads only

Retrieves one HubSpot marketing form definition by form ID.

Get import record informationReads only

Retrieves a HubSpot CRM import record by ID, including its status, metadata, and import configuration when available.

Get landing pageReads only

Retrieve one HubSpot CMS landing page by page ID.

Get landing page draftReads only

Retrieve the full editable draft of one HubSpot landing page.

Get marketing event participation breakdownReads only

Pages participation records for one HubSpot marketing event.

Get pipeline stage auditReads only

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

Get private app daily API usageReads only

Retrieve daily private-app API consumption and limits.

Get productReads only

Retrieves a HubSpot product by its ID.

Get productsReads only

Retrieves multiple HubSpot products in a batch by their IDs or by values of a specified alternate unique identifier property.

Get quote by idReads only

Retrieves a specific HubSpot quote by its unique identifier.

Get record list membershipsReads only

Return the HubSpot lists that contain one CRM record.

Get revisions of a marketing emailReads only

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.

Get segment membersReads only

Tool to retrieve segment (list) members ordered by join timestamp. Use when you need to page through list membership data.

Get sequenceReads only

Retrieves one HubSpot sequence with its ordered steps, settings, and dependencies.

Get settings userReads only

Retrieves one HubSpot settings user by user ID or email.

Get site pageReads only

Retrieve one HubSpot site page by ID.

Get site page draftReads only

Retrieve the full editable draft of one HubSpot site page.

Get source analytics totalsReads only

Retrieves traffic-source analytics for an inclusive date interval. Requires the non-default business-intelligence OAuth scope; default HubSpot connections will receive 403.

Get specific event template for appReads only

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

Get the details of a specified marketing emailReads only

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

Get the variation of an A/B marketing emailReads only

Retrieves the alternate variation of a specified A/B marketing email; the `emailId` must identify an email currently in an A/B test. Requires Marketing Hub Professional or Enterprise subscription.

Get ticketReads only

Retrieves a HubSpot ticket by its ID.

Get ticketsReads only

Retrieves multiple HubSpot tickets in a batch by ticket IDs or values of an alternate unique identifier property.

Get workflow by IDReads only

Retrieves a HubSpot workflow by ID. Uses v4 normally and recovers legacy workflows through v3 only for the known v4 HTML 404 or number-comparative conversion failure; legacy details retain their v3 field names.

Get workflow performanceReads only

Return enrolled, completed, and unenrolled workflow counts by time bucket.

Get workflow revisionReads only

Retrieves a specific historical revision of a HubSpot workflow.

Import file from URL

Start a remote file import and return its task ID and status link.

Initiate data import process

Starts an asynchronous HubSpot CRM import using one uploaded file and an import configuration JSON mapping its columns to HubSpot properties.

List all engagementsReads only

Lists one page from HubSpot's complete legacy aggregate engagement feed.

List all event templates for appReads only

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

List assetsReads only

Lists assets of a specified type associated with a HubSpot marketing campaign, with pagination and optional date-range parameters. Responses are validated against a file-asset schema and do not expose performance metrics.

List associated engagementsReads only

Lists one page of legacy engagements associated with a contact or company.

List association labelsReads only

Return v4 association labels for a directed pair of CRM object types.

List association typesReads only

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

List audit logsReads only

Lists Enterprise-only HubSpot account audit logs with optional filters and pagination.

List automation flowsReads only

Lists HubSpot v4 automation flows with forward pagination.

List blog postsReads only

Lists HubSpot CMS blog posts with documented filters and cursor pagination.

List call dispositionsReads only

Return HubSpot call disposition IDs and labels.

List companiesReads only

Retrieves a paginated list of HubSpot companies.

List company activitiesReads only

Lists a page of activity associations for a HubSpot company and a specified activity type, such as calls, emails, meetings, notes, or tasks. Returns associated record IDs and association metadata, with a cursor for further pages when available.

List company callsReads only

Lists a page of call associations for a HubSpot company, returning call IDs and association types. A cursor can be used to retrieve further pages.

List company meetingsReads only

Lists a page of meetings associated with a HubSpot company, returning meeting IDs and association metadata. A cursor can be used to retrieve further pages.

List contact notesReads only

Lists a page of notes associated with a HubSpot contact, returning note IDs and association metadata. A cursor can be used to retrieve further pages.

List contact propertiesReads only

Lists all contact properties in your HubSpot account, including custom properties you've created. Use this action to discover: - Available property names for updating contacts - Custom properties specific to your HubSpot account - Property types and valid options for enumeration fields - Which properties are read-only vs writable

List contact tasksReads only

Lists a page of tasks associated with a HubSpot contact, returning task IDs and association metadata. A cursor can be used to retrieve further pages.

List contactsReads only

Retrieves a paginated list of HubSpot contacts.

List content templatesReads only

Returns one offset-controlled page of HubSpot content templates.

List conversation channelsReads only

Lists HubSpot conversation channels with sorting and pagination.

List conversation inboxesReads only

Lists HubSpot conversation inbox resources with cursor pagination.

List conversation threadsReads only

Lists HubSpot conversation threads with filtering and forward pagination.

List deal activitiesReads only

Retrieves the first page of note, call, email, meeting, and task associations for a HubSpot deal, including activity IDs and association metadata. The returned count covers the retrieved associations, not necessarily all activities.

List deal meetingsReads only

Lists a page of meetings associated with a HubSpot deal, returning meeting IDs and association metadata. Use the returned cursor to request another page.

List dealsReads only

Retrieves a paginated list of HubSpot deals.

List domainsReads only

Return one cursor-controlled page of connected HubSpot CMS domains.

List email campaign IDsReads only

Lists one paginated page of HubSpot email campaign IDs.

List email campaignsReads only

Lists email-analytics campaign IDs ordered by recent activity.

List email eventsReads only

Lists one page of HubSpot marketing email events; continue with `offset` only while `hasMore` is true.

List EmailsReads only

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

List event occurrencesReads only

Lists one page of HubSpot event occurrences matching optional filters.

List feedback submissions pageReads only

Retrieves a paginated list of HubSpot feedback submissions, with property selection and archive-status filtering. Returned properties are limited to the response model; requested property histories and associated object IDs are not represented in it.

List form submissionsReads only

Lists one cursor-paginated page of submissions for a HubSpot form.

List formsReads only

Lists HubSpot marketing form definitions with cursor pagination.

List granted OAuth scopesReads only

Tool to introspect the current OAuth access token and return its granted scopes and metadata. Use when you need to check which permissions are available before calling an endpoint (e.g., workflows, automation) to proactively detect missing scopes and provide clear remediation guidance.

List landing page revisionsReads only

Lists historical revisions of a HubSpot landing page.

List landing pagesReads only

Return one cursor-controlled page of HubSpot landing pages.

List login activityReads only

Lists HubSpot account login attempts.

List meeting linksReads only

Lists HubSpot scheduling links with optional filters and pagination.

List object associationsReads only

Lists a page of associations from a single CRM record to a specified target object type without fetching the full CRM object. Use the returned paging cursor to request further pages.

List productsReads only

Retrieves a paginated list of HubSpot products.

List quotes pageReads only

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

List recently modified engagementsReads only

Lists one page of engagements from HubSpot's last-30-days or 10,000-most-recently-updated feed.

List sequencesReads only

Lists automation sequences for a specific HubSpot user.

List settings usersReads only

Lists HubSpot account users and their provisioning details.

List site pagesReads only

Return one cursor-controlled page of HubSpot website pages.

List teamsReads only

Lists HubSpot teams and their primary and secondary user memberships.

List ticketsReads only

Retrieves a paginated list of HubSpot tickets.

List user rolesReads only

Lists user roles available in the connected HubSpot account.

Map legacy list IDReads only

Translates a legacy HubSpot list ID to its current list ID.

Merge contacts

Merges two HubSpot contacts into one.

Merge deals

Merges two HubSpot deals into one.

Merge emails

Merges two HubSpot emails into one.

Merge products

Merges two HubSpot products into one.

Merge tickets

Merges two HubSpot tickets into one.

Merge two companies of same type

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

Merge two feedback submissions

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.

Merge two line items of same type

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

Merge two objects of same type

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.

Merge two quotes of same type

Merges two distinct quotes of the same type by consolidating `objectIdToMerge` into `primaryObjectId` (e.g., for combining information or updating terms); this operation is irreversible.

Modify calling extension settings

Updates settings (e.g., display name, UI URL/dimensions, feature flags) for an existing calling extension app, identified by `appId`.

Move list to folder

Move a HubSpot CRM list to a folder, including the root folder.

Partial update quote by quote id

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).

Partially update CRM object by ID

Partially 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.

Partially update pipeline by id

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

Partially update property group

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

Permanently delete company for GDPR compliance

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.

Permanently delete contact for GDPR compliance

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.

Permanently delete contact via GDPR

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

Permanently delete line items for gdpr

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

Publish landing page draft

Apply draft changes to the live version of a HubSpot landing page.

Publish or send a marketing email

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.

Publish site page draft

Apply draft changes to the live version of an already published HubSpot site page.

Purge schema by object type

Permanently and irreversibly deletes the schema for an existing `objectType` in HubSpot CRM; this deprecated endpoint should be used with extreme caution.

Read a batch of CRM object propertiesReads only

Retrieves property definitions (metadata) for a batch of CRM object properties for a specified object type. Returns detailed information about property structure, data types, options, and configuration—not the actual property values of CRM records.

Read a CRM property by nameReads only

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

Read a page of objects by typeReads only

Retrieves a paginated list of objects for a specified and valid HubSpot CRM object type (e.g., 'contacts', 'companies', 'deals', or custom ID).

Read a property groupReads only

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.

Read all properties for object typeReads only

Retrieves definitions and metadata (not actual values) for properties of a specified HubSpot CRM object type (e.g., 'contacts', 'companies', 'deals', or custom objects).

Read batch feedback submissions by id or propertyReads only

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

Read batch of crm objects by id or property valuesReads only

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.

Read batch of line items by id or property valuesReads only

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

Read batch of quotes by property valuesReads only

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.

Read budgetReads only

Retrieves budget totals for a specified HubSpot marketing campaign by its campaign ID.

Read contactReads only

Retrieves a HubSpot contact by its ID.

Read contactsReads only

Batch read multiple HubSpot contacts by their IDs or custom identifier property. This action retrieves up to 100 contacts per request using the HubSpot CRM batch read API. You can specify which contact properties to return and optionally include historical values for properties.

Read crm object by idReads only

Retrieves a specific CRM object (e.g., contact, company, deal, ticket) by its ID or a unique property, optionally including specific properties, history, and associations.

Read feedback submission by idReads only

Reads a HubSpot feedback submission by ID or a custom unique property, with selected properties and property history. The returned properties are limited to the fields represented in the response model.

Read legacy contact profileReads only

Retrieve one legacy HubSpot contact profile by VID when form submissions, identity profiles, merge audits, or legacy-shaped property history are needed.

Read legacy contact profiles by emailReads only

Batch-read up to 100 legacy HubSpot contact profiles by email when form submissions, identity profiles, merge audits, or legacy-shaped property history are needed.

Read legacy contact profiles by VIDReads only

Batch-read up to 100 legacy HubSpot contact profiles by VID when legacy-shaped profile data is needed.

Read property groups for object typeReads only

Retrieves 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.

ReadEmail EmailReads only

Retrieves an existing HubSpot CRM email object by its email ID or by the value of an alternative unique property, with the property name specified separately.

Remove asset association

Disassociates an asset from a HubSpot marketing campaign. Supports a wide range of asset types including forms, landing pages, emails, blog posts, workflows, static lists, and more.

Remove association between CRM records

Tool to remove all associations between two CRM records using the v4 associations endpoint. Use when unlinking records or cleaning up incorrect associations.

Remove association from schema

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

Remove contact secondary email

Removes one secondary email address from a HubSpot contact identified by its legacy contact VID.

Remove deal

Removes a HubSpot deal by its ID.

Remove settings user

Remove a provisioned HubSpot account user by user ID or email.

Remove token from event template

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

Rename CRM list

Renames an existing HubSpot CRM list.

Render event detail templateReads only

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.

Render event header or detail as htmlReads only

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.

Replace all properties of pipeline

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

Replace pipeline stage properties

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.

Reset draft

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.

Restore a revision of a marketing email

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

Restore a revision of a marketing email to draft state

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

Retrieve all object schemasReads only

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

Retrieve all pipelines for specified object typeReads only

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

Retrieve calling settings for appReads only

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

Retrieve existing object schemaReads only

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.

Retrieve line item by idReads only

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

Retrieve line items listReads only

Fetches a paginated list of HubSpot CRM line items, with archive filtering and optional associated object IDs. Returned properties are limited to the fields supported by the response model; requested property history is not retained.

Retrieve owner by ID or user IDReads only

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

Retrieve ownersReads only

Retrieves a page of HubSpot CRM owners, including their ID, name, email, and user ID. The response may include paging information, but this action does not accept a cursor to retrieve further pages.

Retrieve page of crm ownersReads only

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

Retrieve pipeline stage by idReads only

Retrieves details and metadata for a specific HubSpot CRM pipeline stage identified by object type, pipeline ID, and stage ID.

Retrieve pipeline stagesReads only

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

Retrieve timeline event by idsReads only

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.

Retrieve video conference settings by idReads only

Retrieves video conference application settings for a specified app, including meeting webhook URLs and a user verification URL.

Return pipeline by idReads only

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

Schedule blog post

Schedules a HubSpot blog post to publish at a specified date and time.

Schedule landing page

Schedules a HubSpot landing page to publish at a specified date and time.

Schedule site page

Schedule an existing HubSpot CMS site page draft for publication.

Search campaignsReads only

Searches for HubSpot campaigns.

Search CMS contentReads only

Search HubSpot's indexed CMS content.

Search companiesReads only

Searches for HubSpot companies using flexible criteria and filters.

Search contacts by criteriaReads only

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.

Search CRM listsReads only

Searches and pages through HubSpot CRM list definitions.

Search crm objects by criteriaReads only

Searches HubSpot CRM objects by object type using a text query or filter groups, with sorting and pagination. At least one query or filter group is required; property names must be valid for the specified object type.

Search dealsReads only

Searches for HubSpot deals using flexible criteria and filters.

Search emailsReads only

Searches HubSpot CRM email engagement records using a text query, with selectable properties and paginated results.

Search feedback submissionsReads only

Searches HubSpot CRM feedback submissions using a text query, filter groups, sorting, and pagination. Returned properties are limited to the fields represented in the response model.

Search filesReads only

Browses or filters visible HubSpot file-manager records.

Search line items by criteriaReads only

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.

Search productsReads only

Searches for HubSpot products using flexible criteria and filters.

Search quotes by criteriaReads only

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

Search ticketsReads only

Searches for HubSpot tickets using flexible criteria and filters.

Set call recording settings

Configures the URL (`urlToRetrieveAuthedRecording`) that HubSpot uses to retrieve call recordings for a specified third-party calling app (`appId`). The URL must contain a %s placeholder which HubSpot replaces with the engagement's externalId. The calling app must be an existing calling extension app integrated with the HubSpot account.

Unenroll contact from workflow

Remove a contact, identified by email, from a HubSpot contact workflow.

Update a batch of campaigns

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

Update a batch of line items

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.

Update a batch of objects by id or property values

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

Update a marketing email

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

Update batch feedback submissions

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

Update blog post

Update common content fields or exact documented properties on one HubSpot blog post.

Update calling app recording settings

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

Update campaign

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

Update companies

Updates multiple HubSpot companies in a single batch operation.

Update company

Updates properties for an existing HubSpot company.

Update contact

Updates properties for an existing HubSpot contact. Known read-only properties are filtered out; if no properties remain, the current contact is returned without an update.

Update contacts

Updates multiple HubSpot contacts in a single batch operation.

Update deal

Updates properties for an existing HubSpot deal.

Update deals

Updates multiple HubSpot deals in a single batch operation.

Update email subscriptions

IRREVERSIBLY opt out or update email subscription preferences in HubSpot.

Update emails

Updates multiple HubSpot CRM email engagement records by ID in a single batch operation.

Update existing event template

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.

Update existing object schema

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.

Update feedback submission by id

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).

Update landing page

Sparse-update a HubSpot landing page and return its updated state.

Update landing page draft

Partially update a HubSpot landing page draft without publishing it.

Update line item object partially

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.

Update list filters

Replace dynamic-list filters and optionally enroll newly matching records.

Update list memberships

Adds records to or removes records from a manual or snapshot CRM list.

Update pipeline stage by ids

Partially updates a HubSpot CRM pipeline stage identified by object type, pipeline ID, and stage ID. Metadata can be supplied along with other stage fields.

Update product

Updates properties for an existing HubSpot product.

Update products

Updates multiple HubSpot products in a single batch operation.

Update site page

Partially update one HubSpot site page without changing omitted properties.

Update site page draft

Partially update a site-page draft; supplied nested objects replace in full.

Update specific CRM property

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.

Update ticket

Updates properties for an existing HubSpot ticket.

Update tickets

Updates multiple HubSpot tickets in a single batch operation.

Update token on event template

Updates an existing token in a HubSpot CRM event template, including its label, options, or CRM object property mapping. The token name and data type remain unchanged.

Update video conference app settings

Updates webhook URLs for a specified HubSpot video conference application, including URLs for creating, updating and deleting meetings, fetching accounts, and verifying users.

Update workflow

Fully replace an existing Automation v4 workflow at its current revision.

UpdateEmail Email

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.

Upsert companies

Creates or updates as many as 100 HubSpot companies by unique property value.

Upsert contacts

Creates or updates as many as 100 HubSpot contacts by unique property value.

Who Am IReads only

Return the connected HubSpot account (portal id, domain). HubSpot identity is account-level, not per-user.

More in CRM

See them all →

Your company, run by an AI team

Start your company

BRAINER

Continue to B.R.A.I.N.E.R.

Continue with Google or your email.

or