# HubSpot CRM Lists API

**Canonical:** https://apis.io/apis/hubspot/hubspot-crm-lists-api/  
**Provider:** HubSpot — https://apis.io/providers/hubspot/  
**Base URL:** https://api.hubapi.com  
**Documentation:** https://developers.hubspot.com/docs/api-reference/latest/crm/lists/guide

HubSpot CRM Lists API is one of 144 APIs that [HubSpot](https://apis.io/providers/hubspot/) publishes on the [APIs.io](https://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.

HubSpot CRM Lists — 30 operation(s) from HubSpot's published OpenAPI.

## Operations (30)

| Method | Path | Summary |
|---|---|---|
| GET | `/crm/lists/2026-03` | — |
| POST | `/crm/lists/2026-03` | — |
| GET | `/crm/lists/2026-03/folders` | Retrieves a folder. |
| POST | `/crm/lists/2026-03/folders` | Creates a folder |
| PUT | `/crm/lists/2026-03/folders/move-list` | Moves a list to a given folder |
| DELETE | `/crm/lists/2026-03/folders/{folderId}` | Deletes a folder |
| PUT | `/crm/lists/2026-03/folders/{folderId}/move/{newParentFolderId}` | Moves a folder |
| PUT | `/crm/lists/2026-03/folders/{folderId}/rename` | Rename a folder |
| GET | `/crm/lists/2026-03/idmapping` | Translate Legacy List Id to Modern List Id |
| POST | `/crm/lists/2026-03/idmapping` | Translate Legacy List Id to Modern List Id in Batch |
| GET | `/crm/lists/2026-03/object-type-id/{objectTypeId}/name/{listName}` | Fetch List by Name |
| POST | `/crm/lists/2026-03/records/memberships/batch/read` | — |
| GET | `/crm/lists/2026-03/records/{objectTypeId}/{recordId}/memberships` | Get lists record is member of |
| POST | `/crm/lists/2026-03/search` | Search Lists |
| GET | `/crm/lists/2026-03/{listId}` | Fetch List by ID |
| DELETE | `/crm/lists/2026-03/{listId}` | Delete a List |
| GET | `/crm/lists/2026-03/{listId}/memberships` | Fetch List Memberships Ordered by ID |
| DELETE | `/crm/lists/2026-03/{listId}/memberships` | Delete All Records from a List |
| PUT | `/crm/lists/2026-03/{listId}/memberships/add` | Add Records to a List |
| PUT | `/crm/lists/2026-03/{listId}/memberships/add-and-remove` | Add and/or Remove Records from a List |
| PUT | `/crm/lists/2026-03/{listId}/memberships/add-from/{sourceListId}` | Add All Records from a Source List to a Destination List |
| GET | `/crm/lists/2026-03/{listId}/memberships/join-order` | Fetch List Memberships Ordered by Added to List Date |
| PUT | `/crm/lists/2026-03/{listId}/memberships/remove` | Remove Records from a List |
| PUT | `/crm/lists/2026-03/{listId}/restore` | Restore a List |
| GET | `/crm/lists/2026-03/{listId}/schedule-conversion` | Retrieve the conversion details for a list |
| PUT | `/crm/lists/2026-03/{listId}/schedule-conversion` | Schedule or update the conversion of a list to static |
| DELETE | `/crm/lists/2026-03/{listId}/schedule-conversion` | Cancel the conversion of a list |
| GET | `/crm/lists/2026-03/{listId}/size-and-edits-history/between` | — |
| PUT | `/crm/lists/2026-03/{listId}/update-list-filters` | Update List Filter Definition |
| PUT | `/crm/lists/2026-03/{listId}/update-list-name` | Update List Name |

## Machine-readable artifacts (1066)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/openapi/hubspot-crm-lists-api-openapi.yml
- **Documentation** — https://developers.hubspot.com/docs/api/cms/domains
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/domains-api-domain-collection-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/domains-api-domain-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/domains-api-forward-paging-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/domains-api-next-page-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/domains-api-domain-collection-response-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/domains-api-domain-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/domains-api-forward-paging-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/domains-api-next-page-structure.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/domains-api-domain-collection-response-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/domains-api-domain-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/domains-api-forward-paging-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/domains-api-next-page-example.json
- **GraphQL** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/graphql/hubspot-graphql.md
- **Documentation** — https://developers.hubspot.com/docs/api/cms/source-code
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/source-code-api-action-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/source-code-api-asset-file-metadata-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/source-code-api-file-extract-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/source-code-api-file-upload-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/source-code-api-task-locator-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/source-code-api-validation-error-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/source-code-api-validation-result-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/source-code-api-validation-warning-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/source-code-api-action-response-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/source-code-api-asset-file-metadata-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/source-code-api-file-extract-request-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/source-code-api-file-upload-request-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/source-code-api-task-locator-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/source-code-api-validation-error-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/source-code-api-validation-result-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/source-code-api-validation-warning-structure.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/source-code-api-action-response-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/source-code-api-asset-file-metadata-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/source-code-api-file-extract-request-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/source-code-api-file-upload-request-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/source-code-api-task-locator-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/source-code-api-validation-error-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/source-code-api-validation-result-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/source-code-api-validation-warning-example.json
- …and 1026 more, listed in full on the page.

## Other HubSpot APIs (12)

- [HubSpot URL Redirects API](https://apis.io/apis/hubspot/hubspot-url-redirects-api/)
- [HubSpot Pipelines API](https://apis.io/apis/hubspot/hubspot-pipelines-api/)
- [HubSpot Products API](https://apis.io/apis/hubspot/hubspot-products-api/)
- [HubSpot Line Items API](https://apis.io/apis/hubspot/hubspot-line-items-api/)
- [HubSpot Quotes API](https://apis.io/apis/hubspot/hubspot-quotes-api/)
- [HubSpot CRM Properties API](https://apis.io/apis/hubspot/hubspot-crm-properties-api/)
- [HubSpot Owners API](https://apis.io/apis/hubspot/hubspot-owners-api/)
- [HubSpot CRM Imports API](https://apis.io/apis/hubspot/hubspot-crm-imports-api/)
- [HubSpot Custom Objects API](https://apis.io/apis/hubspot/hubspot-custom-objects-api/)
- [HubSpot Marketing Events API](https://apis.io/apis/hubspot/hubspot-marketing-events-api/)
- [HubSpot Forms API](https://apis.io/apis/hubspot/hubspot-forms-api/)
- [HubSpot Workflows API](https://apis.io/apis/hubspot/hubspot-workflows-api/)

## Tags

CRM, Lists

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/hubspot/hubspot-crm-lists-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/hubspot/.