Skip to content

HubSpot: contract 2026-10-28

What changed after HubSpot contract 2026-10-28, and the packages that pin it.

Contract 2026-10-28 is a retired HubSpot contract. Alter still runs it for installed SDKs and pending approvals that pin it. Its full operation reference is not published: the API reference documents the current contract, 2026-11-07. See all contracts.

The last release that pins this contract is version 0.1.3: @alter-ai/hubspot 0.1.3 on npm and alter-sdk-hubspot 0.1.3 on PyPI. Each package page documents that release.

The provider’s native API description of this contract, as Alter published it: hubspot.2026-10-28.openapi.json.

This contract has 1009 operations. Contract 2026-11-07 added 1, removed 0 and changed 43.

Operation links open the current contract’s reference (2026-11-07).

OperationTypeScriptPython
hubspot.site_search_search_sitesiteSearch.searchSitesite_search.search_site
OperationTypeScriptPythonWhat changed
hubspot.associations_get_associations_by_to_object_typeassociations.getAssociationsByToObjectTypeassociations.get_associations_by_to_object_typerequired scopes
hubspot.blog_authors_batch_delete_authorsblogAuthors.batchDeleteAuthorsblog_authors.batch_delete_authorsresponse
hubspot.blog_posts_batch_delete_postsblogPosts.batchDeletePostsblog_posts.batch_delete_postsresponse
hubspot.blog_posts_list_authors_cursorblogPosts.listAuthorsCursorblog_posts.list_authors_cursorrequired scopes
hubspot.blog_posts_list_authors_cursor_queryblogPosts.listAuthorsCursorQueryblog_posts.list_authors_cursor_queryrequired scopes
hubspot.blog_posts_list_posts_cursorblogPosts.listPostsCursorblog_posts.list_posts_cursorrequired scopes
hubspot.blog_posts_list_posts_cursor_queryblogPosts.listPostsCursorQueryblog_posts.list_posts_cursor_queryrequired scopes
hubspot.blog_posts_list_tags_cursorblogPosts.listTagsCursorblog_posts.list_tags_cursorrequired scopes
hubspot.blog_posts_list_tags_cursor_queryblogPosts.listTagsCursorQueryblog_posts.list_tags_cursor_queryrequired scopes
hubspot.blog_tags_batch_delete_tagsblogTags.batchDeleteTagsblog_tags.batch_delete_tagsresponse
hubspot.communication_preferences_links_generatecommunicationPreferences.linksGeneratecommunication_preferences.links_generaterequired scopes
hubspot.communication_preferences_statuses_unsubscribe_allcommunicationPreferences.statusesUnsubscribeAllcommunication_preferences.statuses_unsubscribe_allrequired scopes
hubspot.data_sources_update_by_datasource_iddataSources.updateByDatasourceIddata_sources.update_by_datasource_idrequired scopes
hubspot.files_createfiles.createfiles.createrequired scopes
hubspot.files_create_foldersfiles.createFoldersfiles.create_foldersrequired scopes
hubspot.files_delete_by_file_idfiles.deleteByFileIdfiles.delete_by_file_idrequired scopes
hubspot.files_delete_folders_by_folder_idfiles.deleteFoldersByFolderIdfiles.delete_folders_by_folder_idrequired scopes
hubspot.files_delete_folders_by_folder_pathfiles.deleteFoldersByFolderPathfiles.delete_folders_by_folder_pathrequired scopes
hubspot.files_delete_gdpr_deletefiles.deleteGdprDeletefiles.delete_gdpr_deleterequired scopes
hubspot.files_get_by_file_idfiles.getByFileIdfiles.get_by_file_idrequired scopes
hubspot.files_get_downloadfiles.getDownloadfiles.get_downloadrequired scopes
hubspot.files_get_folders_by_folder_idfiles.getFoldersByFolderIdfiles.get_folders_by_folder_idrequired scopes
hubspot.files_get_folders_by_folder_pathfiles.getFoldersByFolderPathfiles.get_folders_by_folder_pathrequired scopes
hubspot.files_get_signed_urlfiles.getSignedUrlfiles.get_signed_urlrequired scopes
hubspot.files_get_stat_by_pathfiles.getStatByPathfiles.get_stat_by_pathrequired scopes
hubspot.files_replace_by_file_idfiles.replaceByFileIdfiles.replace_by_file_idrequired scopes
hubspot.files_update_by_file_idfiles.updateByFileIdfiles.update_by_file_idrequired scopes
hubspot.hubdb_delete_row_drafthubdb.deleteRowDrafthubdb.delete_row_draftresponse
hubspot.imports_get_import_errorsimports.getImportErrorsimports.get_import_errorsresponse
hubspot.objects_gdpr_deleteobjects.gdprDeleteobjects.gdpr_deleterequired scopes
hubspot.pages_batch_archive_landing_pagespages.batchArchiveLandingPagespages.batch_archive_landing_pagesresponse
hubspot.pages_batch_archive_website_pagespages.batchArchiveWebsitePagespages.batch_archive_website_pagesresponse
hubspot.pages_landing_pages_batch_archive_folderspages.landingPagesBatchArchiveFolderspages.landing_pages_batch_archive_foldersresponse
hubspot.pipelines_get_stagespipelines.getStagespipelines.get_stagesrequired scopes, source
hubspot.pipelines_update_stages_by_stage_idpipelines.updateStagesByStageIdpipelines.update_stages_by_stage_idrequired scopes, source
hubspot.price_books_batch_archive_price_book_itemspriceBooks.batchArchivePriceBookItemsprice_books.batch_archive_price_book_itemsresponse
hubspot.single_send_create_single_sendsingleSend.createSingleSendsingle_send.create_single_sendresponse
hubspot.timeline_batchtimeline.batchtimeline.batchrequired scopes
hubspot.timeline_createtimeline.createtimeline.createrequired scopes
hubspot.transactional_email_create_transactional_emailtransactionalEmail.createTransactionalEmailtransactional_email.create_transactional_emailresponse
hubspot.url_mappings_create_url_mappingurlMappings.createUrlMappingurl_mappings.create_url_mappingrequest
hubspot.url_mappings_get_url_mappingurlMappings.getUrlMappingurl_mappings.get_url_mappingresponse
hubspot.url_mappings_get_url_mappingsurlMappings.getUrlMappingsurl_mappings.get_url_mappingsresponse

Breaking changes in the 2026-11-07 packages

Section titled “Breaking changes in the 2026-11-07 packages”

HubSpot changed these operations upstream, and the current packages follow the provider: code written against the 0.1.3 packages may need a change on upgrading. Each was reviewed when the contract was adopted.

Python methodKindWhat changedWhy
blog_authors.batch_delete_authorsResponse(response): type null -> null/objectHubSpot’s 2026-11-07 reference documents the changed fields as nullable or with another type; the SDK’s response type follows the provider, so code typed against the earlier response may need to handle it.
blog_posts.batch_delete_postsResponse(response): type null -> null/objectHubSpot’s 2026-11-07 reference documents the changed fields as nullable or with another type; the SDK’s response type follows the provider, so code typed against the earlier response may need to handle it.
blog_tags.batch_delete_tagsResponse(response): type null -> null/objectHubSpot’s 2026-11-07 reference documents the changed fields as nullable or with another type; the SDK’s response type follows the provider, so code typed against the earlier response may need to handle it.
hubdb.delete_row_draftResponse(response): type null -> null/objectHubSpot’s 2026-11-07 reference documents the changed fields as nullable or with another type; the SDK’s response type follows the provider, so code typed against the earlier response may need to handle it.
pages.batch_archive_landing_pagesResponse(response): type null -> null/objectHubSpot’s 2026-11-07 reference documents the changed fields as nullable or with another type; the SDK’s response type follows the provider, so code typed against the earlier response may need to handle it.
pages.batch_archive_website_pagesResponse(response): type null -> null/objectHubSpot’s 2026-11-07 reference documents the changed fields as nullable or with another type; the SDK’s response type follows the provider, so code typed against the earlier response may need to handle it.
pages.landing_pages_batch_archive_foldersResponse(response): type null -> null/objectHubSpot’s 2026-11-07 reference documents the changed fields as nullable or with another type; the SDK’s response type follows the provider, so code typed against the earlier response may need to handle it.
price_books.batch_archive_price_book_itemsResponse(response): type null -> null/objectHubSpot’s 2026-11-07 reference documents the changed fields as nullable or with another type; the SDK’s response type follows the provider, so code typed against the earlier response may need to handle it.
associations.get_associations_by_to_object_typeRequestrequired_scopes: added cpq.price_books.read, crm.objects.calls.write, crm.objects.contracts.read, crm.objects.emails.write, crm.objects.forecasts.read, crm.objects.meetings.write, crm.objects.notes.write, crm.objects.tasks.write, crm.objects.tickets.read, crm.objects.tickets.write, oauth, revenue.contracts.readHubSpot’s 2026-11-07 reference names more scopes for this operation; the contract’s scope list follows the provider, as the changelog lists.
blog_posts.list_authors_cursorRequestrequired_scopes: added cms.blogs.blog_posts.readHubSpot’s 2026-11-07 reference names more scopes for this operation; the contract’s scope list follows the provider, as the changelog lists.
blog_posts.list_authors_cursor_queryRequestrequired_scopes: added cms.blogs.blog_posts.readHubSpot’s 2026-11-07 reference names more scopes for this operation; the contract’s scope list follows the provider, as the changelog lists.
blog_posts.list_posts_cursorRequestrequired_scopes: added cms.blogs.blog_posts.readHubSpot’s 2026-11-07 reference names more scopes for this operation; the contract’s scope list follows the provider, as the changelog lists.
blog_posts.list_posts_cursor_queryRequestrequired_scopes: added cms.blogs.blog_posts.readHubSpot’s 2026-11-07 reference names more scopes for this operation; the contract’s scope list follows the provider, as the changelog lists.
blog_posts.list_tags_cursorRequestrequired_scopes: added cms.blogs.blog_posts.readHubSpot’s 2026-11-07 reference names more scopes for this operation; the contract’s scope list follows the provider, as the changelog lists.
blog_posts.list_tags_cursor_queryRequestrequired_scopes: added cms.blogs.blog_posts.readHubSpot’s 2026-11-07 reference names more scopes for this operation; the contract’s scope list follows the provider, as the changelog lists.
communication_preferences.links_generateRequestrequired_scopes: added communication_preferences.read, communication_preferences.writeHubSpot’s 2026-11-07 reference names more scopes for this operation; the contract’s scope list follows the provider, as the changelog lists.
communication_preferences.statuses_unsubscribe_allRequestrequired_scopes: added communication_preferences.writeHubSpot’s 2026-11-07 reference names more scopes for this operation; the contract’s scope list follows the provider, as the changelog lists.
data_sources.update_by_datasource_idRequestrequired_scopes: added data_integration.data_source.json.writeHubSpot’s 2026-11-07 reference names more scopes for this operation; the contract’s scope list follows the provider, as the changelog lists.
files.createRequestrequired_scopes: added files, files.writeHubSpot’s 2026-11-07 reference names more scopes for this operation; the contract’s scope list follows the provider, as the changelog lists.
files.create_foldersRequestrequired_scopes: added files, files.writeHubSpot’s 2026-11-07 reference names more scopes for this operation; the contract’s scope list follows the provider, as the changelog lists.
files.delete_by_file_idRequestrequired_scopes: added files, files.deleteHubSpot’s 2026-11-07 reference names more scopes for this operation; the contract’s scope list follows the provider, as the changelog lists.
files.delete_folders_by_folder_idRequestrequired_scopes: added files, files.deleteHubSpot’s 2026-11-07 reference names more scopes for this operation; the contract’s scope list follows the provider, as the changelog lists.
files.delete_folders_by_folder_pathRequestrequired_scopes: added files, files.deleteHubSpot’s 2026-11-07 reference names more scopes for this operation; the contract’s scope list follows the provider, as the changelog lists.
files.delete_gdpr_deleteRequestrequired_scopes: added files, files.deleteHubSpot’s 2026-11-07 reference names more scopes for this operation; the contract’s scope list follows the provider, as the changelog lists.
files.get_by_file_idRequestrequired_scopes: added files, files.readHubSpot’s 2026-11-07 reference names more scopes for this operation; the contract’s scope list follows the provider, as the changelog lists.
files.get_downloadRequestrequired_scopes: added files, files.readHubSpot’s 2026-11-07 reference names more scopes for this operation; the contract’s scope list follows the provider, as the changelog lists.
files.get_folders_by_folder_idRequestrequired_scopes: added files, files.readHubSpot’s 2026-11-07 reference names more scopes for this operation; the contract’s scope list follows the provider, as the changelog lists.
files.get_folders_by_folder_pathRequestrequired_scopes: added files, files.readHubSpot’s 2026-11-07 reference names more scopes for this operation; the contract’s scope list follows the provider, as the changelog lists.
files.get_signed_urlRequestrequired_scopes: added files, files.readHubSpot’s 2026-11-07 reference names more scopes for this operation; the contract’s scope list follows the provider, as the changelog lists.
files.get_stat_by_pathRequestrequired_scopes: added files, files.readHubSpot’s 2026-11-07 reference names more scopes for this operation; the contract’s scope list follows the provider, as the changelog lists.
files.replace_by_file_idRequestrequired_scopes: added files, files.writeHubSpot’s 2026-11-07 reference names more scopes for this operation; the contract’s scope list follows the provider, as the changelog lists.
files.update_by_file_idRequestrequired_scopes: added files, files.writeHubSpot’s 2026-11-07 reference names more scopes for this operation; the contract’s scope list follows the provider, as the changelog lists.
objects.gdpr_deleteRequestrequired_scopes: added crm.objects.calls.write, crm.objects.emails.write, crm.objects.meetings.write, crm.objects.notes.write, crm.objects.tasks.write, crm.objects.tickets.write, oauthHubSpot’s 2026-11-07 reference names more scopes for this operation; the contract’s scope list follows the provider, as the changelog lists.
pipelines.get_stagesRequestrequired_scopes: added crm.schemas.tickets.read, tickets, timelineHubSpot’s 2026-11-07 reference names more scopes for this operation; the contract’s scope list follows the provider, as the changelog lists.
pipelines.update_stages_by_stage_idRequestrequired_scopes: added crm.schemas.projects.write, crm.schemas.tickets.write, ticketsHubSpot’s 2026-11-07 reference names more scopes for this operation; the contract’s scope list follows the provider, as the changelog lists.
timeline.batchRequestrequired_scopes: added crm.objects.tickets.write, crm.schemas.tickets.write, timeline.writeHubSpot’s 2026-11-07 reference names more scopes for this operation; the contract’s scope list follows the provider, as the changelog lists.
timeline.createRequestrequired_scopes: added crm.objects.tickets.write, crm.schemas.tickets.write, timeline.writeHubSpot’s 2026-11-07 reference names more scopes for this operation; the contract’s scope list follows the provider, as the changelog lists.

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.