Basic

Retrieve all lists in the CRM system. This endpoint allows you to fetch a comprehensive list of all available lists, which can be useful for managing and organizing your CRM data effectively.

post/crm/lists/2026-09/all

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/crm/lists/2026-09/all
  • Auth
    • OAuth 2
      Authorization code: https://app.hubspot.com/oauth/authorize
      Token URL: https://api.hubapi.com/oauth/v1/token scopes: crm.segments.read
    • or OAuth 2
      Authorization code: https://app.hubspot.com/oauth/authorize
      Token URL: https://api.hubapi.com/oauth/v1/token scopes: crm.lists.read

Request body

additionalPropertiesstring[] required

An array of strings representing additional properties to include in the list retrieval.

afterstring

A string used as a paging cursor token to retrieve the next set of results.

countinteger

An integer specifying the number of results to retrieve.

objectTypeIdstring

A string representing the unique identifier for the object type of the lists.

processingTypesstring[] required

An array of strings specifying the types of processing to apply to the request.

Response

successful operation

totalinteger

An integer representing the total number of results available in the search, formatted as a 64-bit integer.

Changes

  • 2026-09e1dd745172d1Revision changes
    • info

      the security scope crm.segments.read was added to the endpoint's security scheme oauth2

    • info

      the security scope crm.lists.read was removed from the endpoint's security scheme oauth2

    • info

      the security scope crm.segments.read was added to the endpoint's security scheme oauth2

    • info

      the security scope crm.lists.read was removed from the endpoint's security scheme oauth2