HUhubspot
Basic

Retrieve join order

Changed on

Retrieve the join order of memberships for a specific list in your HubSpot account. This endpoint allows you to view the order in which records joined the list, which can be useful for tracking membership changes over time.

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

Request

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

Query parameters

afterstring

The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results.

beforestring

A cursor token to retrieve results before a specific point in the list.

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