HubSpot CRM Lists API is one of 144 APIs that HubSpot publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
This API exposes 692 JSON Schema definitions.
Tagged areas include CRM and Lists. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, code examples, and 692 JSON Schemas.
This API exposes
30 operations
across 23 paths,
organized into 3 resource areas,
and defines 109 schemas.
It is described by OpenAPI 3.0.1, at version 2026-03.
Requests are made against a single base URL, https://api.hubapi.com.
30 operations23 paths109 schemas4 DELETE10 GET5 POST11 PUT
Metadata
The identity and technical contract details declared by the specification.
Specification
OpenAPI 3.0.1
API Version
2026-03
Base URL
https://api.hubapi.com
Authentication
API Key, OAuth 2.0, API Key, API Key
Resource Areas
3
Authentication & Security 4
HubSpot CRM Lists API declares
4 security schemes
for authenticating requests.
An API key is passed in the query as hapikey (developer_hapikey).
It supports OAuth 2.0 (oauth2) using the authorizationCode flow, exposing 5 scopes.
An API key is passed in the header as private-app (private_apps).
An API key is passed in the header as private-app-legacy (private_apps_legacy).
Paths & Operations 30
Across 23 paths, the API surfaces 30 operations — 4 DELETE, 10 GET, 5 POST, 11 PUT. They span 3 resource areas: Basic, Batch, Search. Each is listed below with its method, path, parameters, and response codes.
The contract defines 109 schemas that model the data the API accepts and returns. The most detailed are PublicObjectList (16 properties), PublicObjectListSearchResult (13 properties), PublicDatePoint (10 properties), PublicListFolder (9 properties). Each schema is shown below with its type and property counts.
ApiCollectionResponseJoinTimeAndRecordId
object
3 properties1 required
ApiCollectionResponseRecordListMembership
object
3 properties1 required
BatchInputRecordIdInput
object
1 property1 required
BatchResponseRecordIdWithMemberships
object
6 properties4 required
BatchResponseRecordIdWithMembershipsWithErrors
object
8 properties4 required
Error
object
Represents an error response returned by the API when an operation fails. This component is used in various endpoints to provide detailed information about the…
7 properties3 required
ErrorDetail
object
Represents detailed information about an error that occurred in the API. This component is used to provide additional context and specifics about errors, typic…
5 properties1 required
JoinTimeAndRecordId
object
2 properties2 required
ListCreateRequest
object
8 properties3 required
ListCreateResponse
object
1 property1 required
ListFetchResponse
object
1 property1 required
ListFilterUpdateRequest
object
1 property1 required
ListFolderCreateRequest
object
2 properties1 required
ListFolderCreateResponse
object
1 property1 required
ListFolderFetchResponse
object
1 property1 required
ListMoveRequest
object
2 properties2 required
ListSearchRequest
object
8 properties4 required
ListSearchResponse
object
4 properties4 required
ListSizeAndEditHistoryResponse
object
2 properties2 required
ListSizeDataPoint
object
2 properties2 required
ListUpdateResponse
object
1 property
ListsByIdResponse
object
1 property1 required
MembershipChangeRequest
object
2 properties2 required
MembershipsUpdateResponse
object
3 properties3 required
NextPage
object
Specifies the paging information needed to retrieve the next set of results in a paginated API response
2 properties1 required
Paging
object
2 properties
PreviousPage
object
specifies the paging information needed to retrieve the previous set of results in a paginated API response
2 properties1 required
PublicAbsoluteComparativeTimestampRefineBy
object
3 properties3 required
PublicAbsoluteRangedTimestampRefineBy
object
4 properties4 required
PublicAdsSearchFilter
object
6 properties6 required
PublicAdsTimeFilter
object
2 properties2 required
PublicAllHistoryRefineBy
object
1 property1 required
PublicAllPropertyTypesOperation
object
3 properties3 required
PublicAndFilterBranch
object
4 properties4 required
PublicAssociationFilterBranch
object
8 properties8 required
PublicAssociationInListFilter
object
8 properties6 required
PublicBatchMigrationMapping
object
2 properties2 required
PublicBoolPropertyOperation
object
4 properties4 required
PublicCalendarDatePropertyOperation
object
7 properties4 required
PublicCommunicationSubscriptionFilter
object
6 properties5 required
PublicComparativeDatePropertyOperation
object
5 properties4 required
PublicComparativePropertyUpdatedOperation
object
5 properties4 required
PublicComparativeStringPropertyOperation
object
5 properties4 required
PublicConstantFilter
object
3 properties2 required
PublicCtaAnalyticsFilter
object
5 properties3 required
PublicDatePoint
object
10 properties5 required
PublicDatePropertyOperation
object
6 properties6 required
PublicDateTimePropertyOperation
object
5 properties5 required
PublicEmailEventFilter
object
7 properties5 required
PublicEmailSubscriptionFilter
object
4 properties3 required
PublicEnumerationPropertyOperation
object
4 properties4 required
PublicEventAnalyticsFilter
object
5 properties3 required
PublicEventFilterMetadata
object
2 properties2 required
PublicFiscalQuarterReference
object
7 properties3 required
PublicFiscalYearReference
object
7 properties3 required
PublicFormSubmissionFilter
object
5 properties2 required
PublicFormSubmissionOnPageFilter
object
6 properties3 required
PublicInListFilter
object
4 properties3 required
PublicInListFilterMetadata
object
2 properties2 required
PublicIndexOffset
object
9 properties
PublicIndexedTimePoint
object
5 properties3 required
PublicIntegrationEventFilter
object
3 properties3 required
PublicListConversionDate
object
4 properties4 required
PublicListConversionInactivity
object
3 properties3 required
PublicListConversionResponse
object
3 properties1 required
PublicListConversionTime
PublicListFolder
object
9 properties4 required
PublicListPermissions
object
2 properties2 required
PublicMembershipSettings
object
2 properties
PublicMigrationMapping
object
2 properties2 required
PublicMonthReference
object
6 properties2 required
PublicMultiStringPropertyOperation
object
4 properties4 required
PublicNotAllFilterBranch
object
4 properties4 required
PublicNotAnyFilterBranch
object
4 properties4 required
PublicNowReference
object
5 properties1 required
PublicNumOccurrencesRefineBy
object
3 properties1 required
PublicNumberPropertyOperation
object
4 properties4 required
PublicObjectList
object
16 properties6 required
PublicObjectListSearchResult
object
13 properties7 required
PublicOrFilterBranch
object
4 properties4 required
PublicPageViewAnalyticsFilter
object
6 properties3 required
PublicPrivacyAnalyticsFilter
object
3 properties3 required
PublicPropertyFilter
object
3 properties3 required
PublicPropertyReferencedTime
object
5 properties4 required
PublicQuarterReference
object
7 properties3 required
PublicRangedDatePropertyOperation
object
6 properties6 required
PublicRangedNumberPropertyOperation
object
5 properties5 required
PublicRangedTimeOperation
object
9 properties6 required
PublicRelativeComparativeTimestampRefineBy
object
3 properties3 required
PublicRelativeRangedTimestampRefineBy
object
4 properties4 required
PublicRestrictedFilterBranch
object
4 properties4 required
PublicRollingDateRangePropertyOperation
object
5 properties5 required
PublicRollingPropertyUpdatedOperation
object
4 properties4 required
PublicSetOccurrencesRefineBy
object
2 properties2 required
PublicStringPropertyOperation
object
4 properties4 required
PublicSurveyMonkeyFilter
object
3 properties3 required
PublicSurveyMonkeyValueFilter
object
7 properties5 required
PublicTimeOffset
object
3 properties3 required
PublicTimePointOperation
object
7 properties5 required
PublicTodayReference
object
5 properties1 required
PublicUnifiedEventsFilter
object
5 properties2 required
PublicUnifiedEventsFilterBranch
object
8 properties6 required
PublicWebinarFilter
object
3 properties2 required
PublicWeekReference
object
6 properties2 required
PublicYearReference
object
7 properties3 required
RecordIdInput
object
2 properties2 required
RecordIdWithMemberships
object
3 properties3 required
RecordListMembership
object
5 properties4 required
StandardError
object
Ye olde error
8 properties6 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.
Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.
MCP tools for apis
4 tools reach this content
search_api_evangelistSearch every content type across the network at once.
find_relatedThe shared-tag relevance graph — what else covers this.
get_tagEverything one tag labels, across all content types.
guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
A second provider on the same verified email joins the account you already have.
Your account
ⓘWhere this information came from
This is an independent, third-party profile of HubSpot CRM Lists API, published by
API Evangelist. We do not operate, host, resell, or
support these APIs, and we are not affiliated with or endorsed by the company unless stated above.
Everything here is built from publicly available information — the company's own site,
developer portal, documentation, public repositories, and the specifications it publishes for public use.
Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's
public API artifacts, scored against a published rubric. They are not certifications,
endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and
you do not need to justify the request. A removed company is recorded as unrated, never scored
zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy → On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.
