HUhubspot
Basic

List memberships

Changed on

Retrieve the memberships of a specific list in your HubSpot account. This endpoint allows you to paginate through the list memberships using cursor-based pagination. It is useful for obtaining detailed membership information for a given list.

get/crm/lists/2026-09/{listId}/memberships

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/crm/lists/2026-09/{listId}/memberships
  • 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

Path parameters

listIdstring required

The unique identifier of the list whose memberships are to be retrieved.

Query parameters

afterstring

A cursor token for pagination. Use the value from the previous response's paging.next.after field to retrieve the next set of results.

beforestring

A cursor token for pagination. Use this to retrieve the previous set of results.

limitinteger

The maximum number of results to display per page. Defaults to 100.

Response

successful operation

totalinteger

An integer representing the total number of results available.

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

  • 2026-096d0e6dc36ca0Revision 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