Get /crm/v3/lists/{list Id}/memberships /crm/v3/lists/{list Id}/memberships

Fetch List Memberships Ordered by ID

GET/crm/v3/lists/{listId}/memberships

Use it in a workflow

Add a step and choose the HubSpot connector.
Pick the Get /crm/v3/lists/{list Id}/memberships /crm/v3/lists/{list Id}/memberships action (under Lists).
Fill in the fields below, then reference the result from later steps as {{getCrmV3ListsListIdMembershipsCrmV3ListsListIdMemberships.response.data}}.

Request

Path parameters

listIdstringrequired

The **ILS ID** of the list.

Query parameters

afterstring

The paging offset token for the page that comes `after` the previously requested records. If provided, then the records in the response will be the records following the offset, sorted in *ascending* order. Takes precedence over the `before` offset.

beforestring

The paging offset token for the page that comes `before` the previously requested records. If provided, then the records in the response will be the records preceding the offset, sorted in *descending* order.

limitinteger (int32)

The number of records to return in the response. The maximum `limit` is 250.

Default 100

Response

Returns 200 with an object. Read it in later steps with {{getCrmV3ListsListIdMembershipsCrmV3ListsListIdMemberships.response.data.<field>}}.

pagingobject

The cursor to be used for paging through records.

nextobject2 fields

Specifies the paging information needed to retrieve the next set of results in a paginated API response

prevobject2 fields

specifies the paging information needed to retrieve the previous set of results in a paginated API response

resultsarray<object>

membershipTimestampstring (date-time)required

The date and time when the record was added to the list.

recordIdstringrequired

The unique identifier of the record.

totalinteger (int64)

The total number of records that match the query.

json

{
  "results": [
    {
      "membershipTimestamp": "2025-01-01T00:00:00Z",
      "recordId": "string"
    }
  ],
  "paging": {
    "next": {
      "after": "string",
      "link": "string"
    },
    "prev": {
      "before": "string",
      "link": "string"
    }
  },
  "total": 0
}

Need more? See the HubSpot guide for connection setup and behaviour shared by every action.

Was this page helpful?