# HubSpot CRM Lists API

> HubSpot CRM Lists API on Apizie: 31 endpoints (List, Create List, List all, List folders, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/business:hubspot-crm-lists/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `business:hubspot-crm-lists`
- Category: Business
- Status: byok
- Source: https://developers.hubspot.com/docs/api/overview
- Page: https://apizie.tech/api/business/hubspot-crm-lists
- OpenAPI: https://apizie.tech/api/business/hubspot-crm-lists/openapi.json

Basepom for all HubSpot Projects

## Endpoints

### List
`GET https://apizie.tech/v1/business:hubspot-crm-lists/get-crm-lists-2026-09` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| includeFilters | boolean | no | A boolean indicating whether to include filters applied to the lists in the response. Defaults to false. |
| listIds | array | no | An array of list IDs to filter the lists returned. Each ID should be a string. |

### Create List
`POST https://apizie.tech/v1/business:hubspot-crm-lists/post-crm-lists-2026-09` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### List all
`POST https://apizie.tech/v1/business:hubspot-crm-lists/post-crm-lists-2026-09-all-crm-lists-2026-09-beta-all` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### List folders
`GET https://apizie.tech/v1/business:hubspot-crm-lists/get-crm-lists-2026-09-folders` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| folderId | string | no | The unique identifier of the folder to retrieve. Defaults to '0' if not specified. |

### Create Folder
`POST https://apizie.tech/v1/business:hubspot-crm-lists/post-crm-lists-2026-09-folders` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Move List
`POST https://apizie.tech/v1/business:hubspot-crm-lists/put-crm-lists-2026-09-folders-move-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Delete folder
`POST https://apizie.tech/v1/business:hubspot-crm-lists/delete-crm-lists-2026-09-folders-folder-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| folderId | string | yes | The unique identifier of the folder to delete. |

### Move Folder
`POST https://apizie.tech/v1/business:hubspot-crm-lists/put-crm-lists-2026-09-folders-folder-id-move-new-parent-fold` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| folderId | string | yes | The unique identifier of the folder to be moved. |
| newParentFolderId | string | yes | The unique identifier of the new parent folder where the folder will be moved. |

### Rename folder
`POST https://apizie.tech/v1/business:hubspot-crm-lists/put-crm-lists-2026-09-folders-folder-id-rename` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| folderId | string | yes | The unique identifier of the folder to be renamed. |
| newFolderName | string | no | The new name for the folder. It should be a string representing the desired folder name. |

### Retrieve ID Mapping
`GET https://apizie.tech/v1/business:hubspot-crm-lists/get-crm-lists-2026-09-idmapping` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legacyListId | string | no | The legacy list ID for which you want to retrieve the current ID mapping. |

### Map IDs
`POST https://apizie.tech/v1/business:hubspot-crm-lists/post-crm-lists-2026-09-idmapping` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Retrieve List
`GET https://apizie.tech/v1/business:hubspot-crm-lists/get-crm-lists-2026-09-object-type-id-object-type-id-name-lis` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| listName | string | yes | The name of the list to retrieve. |
| objectTypeId | string | yes | The unique identifier of the object type associated with the list. |
| includeFilters | boolean | no | A boolean indicating whether to include filters in the response. Defaults to false. |

### Batch read memberships
`POST https://apizie.tech/v1/business:hubspot-crm-lists/post-crm-lists-2026-09-records-memberships-batch-read` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Retrieve memberships
`GET https://apizie.tech/v1/business:hubspot-crm-lists/get-crm-lists-2026-09-records-object-type-id-record-id-membe` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| objectTypeId | string | yes | The unique identifier of the object type to which the record belongs. |
| recordId | string | yes | The unique identifier of the record for which memberships are being retrieved. |

### Search Lists
`POST https://apizie.tech/v1/business:hubspot-crm-lists/post-crm-lists-2026-09-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Retrieve list
`GET https://apizie.tech/v1/business:hubspot-crm-lists/get-crm-lists-2026-09-list-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| listId | string | yes | The unique identifier of the list to retrieve. |
| includeFilters | boolean | no | A boolean indicating whether to include the list's filters in the response. Defaults to false. |

### Delete
`POST https://apizie.tech/v1/business:hubspot-crm-lists/delete-crm-lists-2026-09-list-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| listId | string | yes | The unique identifier of the list to delete. |

### List memberships
`GET https://apizie.tech/v1/business:hubspot-crm-lists/get-crm-lists-2026-09-list-id-memberships` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| listId | string | yes | The unique identifier of the list whose memberships are to be retrieved. |
| after | string | no | A cursor token for pagination. Use the value from the previous response's paging.next.after field to retrieve the next set of results. |
| before | string | no | A cursor token for pagination. Use this to retrieve the previous set of results. |
| limit | integer | no | The maximum number of results to display per page. Defaults to 100. |

### Delete memberships
`POST https://apizie.tech/v1/business:hubspot-crm-lists/delete-crm-lists-2026-09-list-id-memberships` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| listId | string | yes | The unique identifier of the list whose memberships are to be deleted. |

### Add memberships
`POST https://apizie.tech/v1/business:hubspot-crm-lists/put-crm-lists-2026-09-list-id-memberships-add` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| listId | string | yes | The unique identifier of the list to which memberships will be added. |
| body | object | yes | JSON request body |

### Update memberships
`POST https://apizie.tech/v1/business:hubspot-crm-lists/put-crm-lists-2026-09-list-id-memberships-add-and-remove` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| listId | string | yes | The unique identifier of the list whose memberships are to be updated. |
| body | object | yes | JSON request body |

### Add memberships
`POST https://apizie.tech/v1/business:hubspot-crm-lists/put-crm-lists-2026-09-list-id-memberships-add-from-source-li` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| listId | string | yes | The unique identifier of the target list to which memberships will be added. |
| sourceListId | string | yes | The unique identifier of the source list from which memberships will be transferred. |

### Retrieve join order
`GET https://apizie.tech/v1/business:hubspot-crm-lists/get-crm-lists-2026-09-list-id-memberships-join-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| listId | string | yes | The unique identifier of the list whose membership join order is being retrieved. |
| after | string | no | The paging cursor token of the last successfully read resource will be returned as the `paging.next.after` JSON property of a paged… |
| before | string | no | A cursor token to retrieve results before a specific point in the list. |
| limit | integer | no | The maximum number of results to display per page. Defaults to 100. |

### Remove memberships
`POST https://apizie.tech/v1/business:hubspot-crm-lists/put-crm-lists-2026-09-list-id-memberships-remove` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| listId | string | yes | The unique identifier of the list from which memberships will be removed. |
| body | object | yes | JSON request body |

### Restore
`POST https://apizie.tech/v1/business:hubspot-crm-lists/put-crm-lists-2026-09-list-id-restore` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| listId | string | yes | The unique identifier of the list to restore. |

### Retrieve
`GET https://apizie.tech/v1/business:hubspot-crm-lists/get-crm-lists-2026-09-list-id-schedule-conversion` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| listId | string | yes | The unique identifier of the list for which the scheduled conversion details are to be retrieved. |

### Schedule Conversion
`POST https://apizie.tech/v1/business:hubspot-crm-lists/put-crm-lists-2026-09-list-id-schedule-conversion` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| listId | string | yes | The unique identifier of the list for which the conversion schedule is to be set. |
| body | object | yes | JSON request body |

### Delete schedule conversion
`POST https://apizie.tech/v1/business:hubspot-crm-lists/delete-crm-lists-2026-09-list-id-schedule-conversion` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| listId | string | yes | The unique identifier of the list for which the scheduled conversion is to be deleted. |

### Retrieve history
`GET https://apizie.tech/v1/business:hubspot-crm-lists/get-crm-lists-2026-09-list-id-size-and-edits-history-between` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| listId | string | yes | The unique identifier of the list for which the size and edits history is being retrieved. |
| endDate | string | no | The end date for the history retrieval, formatted as a date-time string. |
| startDate | string | no | The start date for the history retrieval, formatted as a date-time string. |

### Update list filters
`POST https://apizie.tech/v1/business:hubspot-crm-lists/put-crm-lists-2026-09-list-id-update-list-filters` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| listId | string | yes | The unique identifier of the list whose filters are to be updated. |
| enrollObjectsInWorkflows | boolean | no | A boolean indicating whether to enroll objects in workflows based on the updated filters. Defaults to false. |
| body | object | yes | JSON request body |

### Update list name
`POST https://apizie.tech/v1/business:hubspot-crm-lists/put-crm-lists-2026-09-list-id-update-list-name` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| listId | string | yes | The unique identifier of the list whose name is to be updated. |
| includeFilters | boolean | no | A boolean indicating whether to include filters in the response. Defaults to false. |
| listName | string | no | The new name for the list. It should be a string representing the desired name. |

## Example
```
curl "https://apizie.tech/v1/business:hubspot-crm-lists/get-crm-lists-2026-09" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the HubSpot CRM Lists API?
Create a free Apizie key, then send GET https://apizie.tech/v1/business:hubspot-crm-lists/get-crm-lists-2026-09 with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the HubSpot CRM Lists API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. HubSpot CRM Lists itself also needs your own key from hubapi.com.

### Can AI agents use the HubSpot CRM Lists API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key business:hubspot-crm-lists.

### What is the status of the HubSpot CRM Lists API?
Needs your own provider key (bring your own key)