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.
Packages
Section titled “Packages”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.
Specifications
Section titled “Specifications”The provider’s native API description of this contract, as Alter published it: hubspot.2026-10-28.openapi.json.
Changes in contract 2026-11-07
Section titled “Changes in contract 2026-11-07”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).
| Operation | TypeScript | Python |
|---|---|---|
| hubspot.site_search_search_site | siteSearch.searchSite | site_search.search_site |
Changed
Section titled “Changed”| Operation | TypeScript | Python | What changed |
|---|---|---|---|
| hubspot.associations_get_associations_by_to_object_type | associations.getAssociationsByToObjectType | associations.get_associations_by_to_object_type | required scopes |
| hubspot.blog_authors_batch_delete_authors | blogAuthors.batchDeleteAuthors | blog_authors.batch_delete_authors | response |
| hubspot.blog_posts_batch_delete_posts | blogPosts.batchDeletePosts | blog_posts.batch_delete_posts | response |
| hubspot.blog_posts_list_authors_cursor | blogPosts.listAuthorsCursor | blog_posts.list_authors_cursor | required scopes |
| hubspot.blog_posts_list_authors_cursor_query | blogPosts.listAuthorsCursorQuery | blog_posts.list_authors_cursor_query | required scopes |
| hubspot.blog_posts_list_posts_cursor | blogPosts.listPostsCursor | blog_posts.list_posts_cursor | required scopes |
| hubspot.blog_posts_list_posts_cursor_query | blogPosts.listPostsCursorQuery | blog_posts.list_posts_cursor_query | required scopes |
| hubspot.blog_posts_list_tags_cursor | blogPosts.listTagsCursor | blog_posts.list_tags_cursor | required scopes |
| hubspot.blog_posts_list_tags_cursor_query | blogPosts.listTagsCursorQuery | blog_posts.list_tags_cursor_query | required scopes |
| hubspot.blog_tags_batch_delete_tags | blogTags.batchDeleteTags | blog_tags.batch_delete_tags | response |
| hubspot.communication_preferences_links_generate | communicationPreferences.linksGenerate | communication_preferences.links_generate | required scopes |
| hubspot.communication_preferences_statuses_unsubscribe_all | communicationPreferences.statusesUnsubscribeAll | communication_preferences.statuses_unsubscribe_all | required scopes |
| hubspot.data_sources_update_by_datasource_id | dataSources.updateByDatasourceId | data_sources.update_by_datasource_id | required scopes |
| hubspot.files_create | files.create | files.create | required scopes |
| hubspot.files_create_folders | files.createFolders | files.create_folders | required scopes |
| hubspot.files_delete_by_file_id | files.deleteByFileId | files.delete_by_file_id | required scopes |
| hubspot.files_delete_folders_by_folder_id | files.deleteFoldersByFolderId | files.delete_folders_by_folder_id | required scopes |
| hubspot.files_delete_folders_by_folder_path | files.deleteFoldersByFolderPath | files.delete_folders_by_folder_path | required scopes |
| hubspot.files_delete_gdpr_delete | files.deleteGdprDelete | files.delete_gdpr_delete | required scopes |
| hubspot.files_get_by_file_id | files.getByFileId | files.get_by_file_id | required scopes |
| hubspot.files_get_download | files.getDownload | files.get_download | required scopes |
| hubspot.files_get_folders_by_folder_id | files.getFoldersByFolderId | files.get_folders_by_folder_id | required scopes |
| hubspot.files_get_folders_by_folder_path | files.getFoldersByFolderPath | files.get_folders_by_folder_path | required scopes |
| hubspot.files_get_signed_url | files.getSignedUrl | files.get_signed_url | required scopes |
| hubspot.files_get_stat_by_path | files.getStatByPath | files.get_stat_by_path | required scopes |
| hubspot.files_replace_by_file_id | files.replaceByFileId | files.replace_by_file_id | required scopes |
| hubspot.files_update_by_file_id | files.updateByFileId | files.update_by_file_id | required scopes |
| hubspot.hubdb_delete_row_draft | hubdb.deleteRowDraft | hubdb.delete_row_draft | response |
| hubspot.imports_get_import_errors | imports.getImportErrors | imports.get_import_errors | response |
| hubspot.objects_gdpr_delete | objects.gdprDelete | objects.gdpr_delete | required scopes |
| hubspot.pages_batch_archive_landing_pages | pages.batchArchiveLandingPages | pages.batch_archive_landing_pages | response |
| hubspot.pages_batch_archive_website_pages | pages.batchArchiveWebsitePages | pages.batch_archive_website_pages | response |
| hubspot.pages_landing_pages_batch_archive_folders | pages.landingPagesBatchArchiveFolders | pages.landing_pages_batch_archive_folders | response |
| hubspot.pipelines_get_stages | pipelines.getStages | pipelines.get_stages | required scopes, source |
| hubspot.pipelines_update_stages_by_stage_id | pipelines.updateStagesByStageId | pipelines.update_stages_by_stage_id | required scopes, source |
| hubspot.price_books_batch_archive_price_book_items | priceBooks.batchArchivePriceBookItems | price_books.batch_archive_price_book_items | response |
| hubspot.single_send_create_single_send | singleSend.createSingleSend | single_send.create_single_send | response |
| hubspot.timeline_batch | timeline.batch | timeline.batch | required scopes |
| hubspot.timeline_create | timeline.create | timeline.create | required scopes |
| hubspot.transactional_email_create_transactional_email | transactionalEmail.createTransactionalEmail | transactional_email.create_transactional_email | response |
| hubspot.url_mappings_create_url_mapping | urlMappings.createUrlMapping | url_mappings.create_url_mapping | request |
| hubspot.url_mappings_get_url_mapping | urlMappings.getUrlMapping | url_mappings.get_url_mapping | response |
| hubspot.url_mappings_get_url_mappings | urlMappings.getUrlMappings | url_mappings.get_url_mappings | response |
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 method | Kind | What changed | Why |
|---|---|---|---|
blog_authors.batch_delete_authors | Response | (response): type null -> null/object | HubSpot’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_posts | Response | (response): type null -> null/object | HubSpot’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_tags | Response | (response): type null -> null/object | HubSpot’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_draft | Response | (response): type null -> null/object | HubSpot’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_pages | Response | (response): type null -> null/object | HubSpot’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_pages | Response | (response): type null -> null/object | HubSpot’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_folders | Response | (response): type null -> null/object | HubSpot’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_items | Response | (response): type null -> null/object | HubSpot’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_type | Request | required_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.read | HubSpot’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 | Request | required_scopes: added cms.blogs.blog_posts.read | HubSpot’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_query | Request | required_scopes: added cms.blogs.blog_posts.read | HubSpot’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 | Request | required_scopes: added cms.blogs.blog_posts.read | HubSpot’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_query | Request | required_scopes: added cms.blogs.blog_posts.read | HubSpot’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 | Request | required_scopes: added cms.blogs.blog_posts.read | HubSpot’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_query | Request | required_scopes: added cms.blogs.blog_posts.read | HubSpot’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_generate | Request | required_scopes: added communication_preferences.read, communication_preferences.write | HubSpot’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_all | Request | required_scopes: added communication_preferences.write | HubSpot’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_id | Request | required_scopes: added data_integration.data_source.json.write | HubSpot’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 | Request | required_scopes: added files, files.write | HubSpot’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_folders | Request | required_scopes: added files, files.write | HubSpot’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_id | Request | required_scopes: added files, files.delete | HubSpot’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_id | Request | required_scopes: added files, files.delete | HubSpot’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_path | Request | required_scopes: added files, files.delete | HubSpot’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_delete | Request | required_scopes: added files, files.delete | HubSpot’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_id | Request | required_scopes: added files, files.read | HubSpot’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_download | Request | required_scopes: added files, files.read | HubSpot’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_id | Request | required_scopes: added files, files.read | HubSpot’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_path | Request | required_scopes: added files, files.read | HubSpot’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_url | Request | required_scopes: added files, files.read | HubSpot’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_path | Request | required_scopes: added files, files.read | HubSpot’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_id | Request | required_scopes: added files, files.write | HubSpot’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_id | Request | required_scopes: added files, files.write | HubSpot’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_delete | Request | required_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, oauth | HubSpot’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_stages | Request | required_scopes: added crm.schemas.tickets.read, tickets, timeline | HubSpot’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_id | Request | required_scopes: added crm.schemas.projects.write, crm.schemas.tickets.write, tickets | HubSpot’s 2026-11-07 reference names more scopes for this operation; the contract’s scope list follows the provider, as the changelog lists. |
timeline.batch | Request | required_scopes: added crm.objects.tickets.write, crm.schemas.tickets.write, timeline.write | HubSpot’s 2026-11-07 reference names more scopes for this operation; the contract’s scope list follows the provider, as the changelog lists. |
timeline.create | Request | required_scopes: added crm.objects.tickets.write, crm.schemas.tickets.write, timeline.write | HubSpot’s 2026-11-07 reference names more scopes for this operation; the contract’s scope list follows the provider, as the changelog lists. |