HubSpot CRM Lists API

openapi: 3.0.1
info:
  title: HubSpot CRM Lists
  description: Basepom for all HubSpot Projects
  version: 2026-03
  x-hubspot-product-tier-requirements:
    marketing: FREE
    sales: FREE
    service: FREE
    cms: FREE
    commerce: FREE
    crmHub: FREE
    dataHub: FREE
servers:
- url: https://api.hubapi.com
tags:
- name: Basic
- name: Batch
- name: Search
paths:
  /crm/lists/2026-03:
    get:
      tags:
      - Basic
      operationId: get-/crm/lists/2026-03_/crm/lists/v3
      parameters:
      - name: includeFilters
        in: query
        required: false
        style: form
        explode: true
        schema:
          type: boolean
          default: false
      - name: listIds
        in: query
        required: false
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListsByIdResponse'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm.segments.read
      - oauth2:
        - crm.lists.read
    post:
      tags:
      - Basic
      operationId: post-/crm/lists/2026-03_/crm/lists/v3
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListCreateRequest'
        required: true
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListCreateResponse'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm.lists.write
      - oauth2:
        - cms.membership.access_groups.write
      - oauth2:
        - crm.segments.write
  /crm/lists/2026-03/folders:
    get:
      tags:
      - Basic
      summary: Retrieves a folder.
      description: Retrieves a folder and recursively includes all folders via the childNodes attribute.  The
        child lists field will be empty in all child nodes. Only the folder retrieved will include the
        child lists in that folder.
      operationId: get-/crm/lists/2026-03/folders_/crm/lists/v3/folders
      parameters:
      - name: folderId
        in: query
        description: The Id of the folder to retrieve.
        required: false
        style: form
        explode: true
        schema:
          type: string
          default: '0'
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFolderFetchResponse'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm.segments.read
      - oauth2:
        - crm.lists.read
    post:
      tags:
      - Basic
      summary: Creates a folder
      description: Creates a folder with the given information.
      operationId: post-/crm/lists/2026-03/folders_/crm/lists/v3/folders
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListFolderCreateRequest'
        required: true
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFolderCreateResponse'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm.lists.write
        - crm.segments.read
      - oauth2:
        - cms.membership.access_groups.write
        - crm.lists.read
      - oauth2:
        - crm.segments.read
        - crm.segments.write
      - oauth2:
        - crm.lists.read
        - crm.segments.write
      - oauth2:
        - crm.lists.read
        - crm.lists.write
      - oauth2:
        - cms.membership.access_groups.write
        - crm.segments.read
  /crm/lists/2026-03/folders/move-list:
    put:
      tags:
      - Basic
      summary: Moves a list to a given folder
      description: Given a list and a folder, the list will be moved to that folder.
      operationId: put-/crm/lists/2026-03/folders/move-list_/crm/lists/v3/folders/move-list
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListMoveRequest'
        required: true
      responses:
        '204':
          description: No content
          content: {}
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm.lists.write
        - crm.segments.read
      - oauth2:
        - cms.membership.access_groups.write
        - crm.lists.read
      - oauth2:
        - crm.segments.read
        - crm.segments.write
      - oauth2:
        - crm.lists.read
        - crm.segments.write
      - oauth2:
        - crm.lists.read
        - crm.lists.write
      - oauth2:
        - cms.membership.access_groups.write
        - crm.segments.read
  /crm/lists/2026-03/folders/{folderId}:
    delete:
      tags:
      - Basic
      summary: Deletes a folder
      description: Deletes the folder with the given Id.
      operationId: delete-/crm/lists/2026-03/folders/{folderId}_/crm/lists/v3/folders/{folderId}
      parameters:
      - name: folderId
        in: path
        description: The ID of the folder to delete
        required: true
        style: simple
        explode: false
        schema:
          type: string
      responses:
        '204':
          description: No content
          content: {}
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm.lists.write
        - crm.segments.read
      - oauth2:
        - cms.membership.access_groups.write
        - crm.lists.read
      - oauth2:
        - crm.segments.read
        - crm.segments.write
      - oauth2:
        - crm.lists.read
        - crm.segments.write
      - oauth2:
        - crm.lists.read
        - crm.lists.write
      - oauth2:
        - cms.membership.access_groups.write
        - crm.segments.read
  /crm/lists/2026-03/folders/{folderId}/move/{newParentFolderId}:
    put:
      tags:
      - Basic
      summary: Moves a folder
      description: This moves the folder from its current location to a new location. It updates the parent
        of this folder to the new Id given.
      operationId: put-/crm/lists/2026-03/folders/{folderId}/move/{newParentFolderId}_/crm/lists/v3/folders/{folderId}/move/{newParentFolderId}
      parameters:
      - name: folderId
        in: path
        description: The ID of the folder to move
        required: true
        style: simple
        explode: false
        schema:
          type: string
      - name: newParentFolderId
        in: path
        description: The ID for the target parent folder.
        required: true
        style: simple
        explode: false
        schema:
          type: string
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFolderFetchResponse'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm.lists.write
        - crm.segments.read
      - oauth2:
        - cms.membership.access_groups.write
        - crm.lists.read
      - oauth2:
        - crm.segments.read
        - crm.segments.write
      - oauth2:
        - crm.lists.read
        - crm.segments.write
      - oauth2:
        - crm.lists.read
        - crm.lists.write
      - oauth2:
        - cms.membership.access_groups.write
        - crm.segments.read
  /crm/lists/2026-03/folders/{folderId}/rename:
    put:
      tags:
      - Basic
      summary: Rename a folder
      description: Renames the given folderId with a new name.
      operationId: put-/crm/lists/2026-03/folders/{folderId}/rename_/crm/lists/v3/folders/{folderId}/rename
      parameters:
      - name: folderId
        in: path
        description: The ID of the folder to rename
        required: true
        style: simple
        explode: false
        schema:
          type: string
      - name: newFolderName
        in: query
        description: The new name of the folder.
        required: false
        style: form
        explode: true
        schema:
          type: string
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFolderFetchResponse'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm.lists.write
        - crm.segments.read
      - oauth2:
        - cms.membership.access_groups.write
        - crm.lists.read
      - oauth2:
        - crm.segments.read
        - crm.segments.write
      - oauth2:
        - crm.lists.read
        - crm.segments.write
      - oauth2:
        - crm.lists.read
        - crm.lists.write
      - oauth2:
        - cms.membership.access_groups.write
        - crm.segments.read
  /crm/lists/2026-03/idmapping:
    get:
      tags:
      - Basic
      summary: Translate Legacy List Id to Modern List Id
      description: This API allows translation of legacy list id to list id. This is a temporary API allowed
        for mapping old id's to new id's and will expire on May 30th, 2025.
      operationId: get-/crm/lists/2026-03/idmapping_/crm/lists/v3/idmapping
      parameters:
      - name: legacyListId
        in: query
        description: The legacy list id from lists v1 API.
        required: false
        style: form
        explode: true
        schema:
          type: string
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicMigrationMapping'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm.segments.read
      - oauth2:
        - crm.lists.read
    post:
      tags:
      - Basic
      summary: Translate Legacy List Id to Modern List Id in Batch
      description: This API allows translation of a batch of legacy list id's to list id's. This allows
        for a maximum of 10,000 id's. This is a temporary API allowed for mapping old id's to new id's
        and will expire on May 30th, 2025.
      operationId: post-/crm/lists/2026-03/idmapping_/crm/lists/v3/idmapping
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type: string
        required: true
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicBatchMigrationMapping'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm.segments.read
      - oauth2:
        - crm.lists.read
  /crm/lists/2026-03/object-type-id/{objectTypeId}/name/{listName}:
    get:
      tags:
      - Basic
      summary: Fetch List by Name
      description: Fetch a single list by list name and object type.
      operationId: get-/crm/lists/2026-03/object-type-id/{objectTypeId}/name/{listName}_/crm/lists/v3/object-type-id/{objectTypeId}/name/{listName}
      parameters:
      - name: listName
        in: path
        description: The name of the list to fetch. This is **not** case sensitive.
        required: true
        style: simple
        explode: false
        schema:
          type: string
      - name: objectTypeId
        in: path
        description: The object type ID of the object types stored by the list to fetch. For example,
          `0-1` for a `CONTACT` list.
        required: true
        style: simple
        explode: false
        schema:
          type: string
      - name: includeFilters
        in: query
        description: A flag indicating whether or not the response object list definition should include
          a filter branch definition. By default, object list definitions will not have their filter branch
          definitions included in the response.
        required: false
        style: form
        explode: true
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFetchResponse'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm.segments.read
      - oauth2:
        - crm.lists.read
  /crm/lists/2026-03/records/memberships/batch/read:
    post:
      tags:
      - Batch
      operationId: post-/crm/lists/2026-03/records/memberships/batch/read_/crm/lists/v3/records/memberships/batch/read
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchInputRecordIdInput'
        required: true
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchResponseRecordIdWithMemberships'
        '207':
          description: multiple statuses
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchResponseRecordIdWithMembershipsWithErrors'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm.segments.read
      - oauth2:
        - crm.lists.read
  /crm/lists/2026-03/records/{objectTypeId}/{recordId}/memberships:
    get:
      tags:
      - Basic
      summary: Get lists record is member of
      description: For given record provide lists this record is member of.
      operationId: get-/crm/lists/2026-03/records/{objectTypeId}/{recordId}/memberships_/crm/lists/v3/records/{objectTypeId}/{recordId}/memberships
      parameters:
      - name: objectTypeId
        in: path
        description: Object type id of the record
        required: true
        style: simple
        explode: false
        schema:
          type: string
      - name: recordId
        in: path
        description: Id of the record
        required: true
        style: simple
        explode: false
        schema:
          type: string
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiCollectionResponseRecordListMembership'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm.segments.read
      - oauth2:
        - crm.lists.read
  /crm/lists/2026-03/search:
    post:
      tags:
      - Search
      summary: Search Lists
      description: Search lists by list name or page through all lists by providing an empty `query` value.
      operationId: post-/crm/lists/2026-03/search_/crm/lists/v3/search
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListSearchRequest'
        required: true
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListSearchResponse'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm.segments.read
      - oauth2:
        - crm.lists.read
  /crm/lists/2026-03/{listId}:
    get:
      tags:
      - Basic
      summary: Fetch List by ID
      description: Fetch a single list by **ILS list ID**.
      operationId: get-/crm/lists/2026-03/{listId}_/crm/lists/v3/{listId}
      parameters:
      - name: listId
        in: path
        description: The **ILS ID** of the list to fetch.
        required: true
        style: simple
        explode: false
        schema:
          type: string
      - name: includeFilters
        in: query
        description: A flag indicating whether or not the response object list definition should include
          a filter branch definition. By default, object list definitions will not have their filter branch
          definitions included in the response.
        required: false
        style: form
        explode: true
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFetchResponse'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm.segments.read
      - oauth2:
        - crm.lists.read
    delete:
      tags:
      - Basic
      summary: Delete a List
      description: Delete a list by **ILS list ID**. Lists deleted through this endpoint can be restored
        up to 90-days following the delete. After 90-days, the list is purged and can no longer be restored.
      operationId: delete-/crm/lists/2026-03/{listId}_/crm/lists/v3/{listId}
      parameters:
      - name: listId
        in: path
        description: The **ILS ID** of the list to delete.
        required: true
        style: simple
        explode: false
        schema:
          type: string
      responses:
        '204':
          description: No content
          content: {}
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm.lists.write
        - crm.segments.read
      - oauth2:
        - cms.membership.access_groups.write
        - crm.lists.read
      - oauth2:
        - crm.segments.read
        - crm.segments.write
      - oauth2:
        - crm.lists.read
        - crm.segments.write
      - oauth2:
        - crm.lists.read
        - crm.lists.write
      - oauth2:
        - cms.membership.access_groups.write
        - crm.segments.read
  /crm/lists/2026-03/{listId}/memberships:
    get:
      tags:
      - Basic
      summary: Fetch List Memberships Ordered by ID
      description: 'Fetch the memberships of a list in order sorted by the `recordId` of the records in
        the list.


        The `recordId`s are sorted in *ascending* order if an `after` offset or no offset is provided.
        If only a `before` offset is provided, then the records are sorted in *descending* order.


        The `after` offset parameter will take precedence over the `before` offset in a case where both
        are provided.'
      operationId: get-/crm/lists/2026-03/{listId}/memberships_/crm/lists/v3/{listId}/memberships
      parameters:
      - name: listId
        in: path
        description: The **ILS ID** of the list.
        required: true
        style: simple
        explode: false
        schema:
          type: string
      - name: after
        in: query
        description: '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.'
        required: false
        style: form
        explode: true
        schema:
          type: string
      - name: before
        in: query
        description: '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.'
        required: false
        style: form
        explode: true
        schema:
          type: string
      - name: limit
        in: query
        description: The number of records to return in the response. The maximum `limit` is 250.
        required: false
        style: form
        explode: true
        schema:
          type: integer
          format: int32
          default: 100
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiCollectionResponseJoinTimeAndRecordId'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm.segments.read
      - oauth2:
        - crm.lists.read
    delete:
      tags:
      - Basic
      summary: Delete All Records from a List
      description: 'Remove **all** of the records from a list. ***Note:*** *The list is not deleted.*


        This endpoint only works for lists that have a `processingType` of `MANUAL` or `SNAPSHOT`.


        This endpoint only supports lists that have less than 100,000 memberships.'
      operationId: delete-/crm/lists/2026-03/{listId}/memberships_/crm/lists/v3/{listId}/memberships
      parameters:
      - name: listId
        in: path
        description: The **ILS ID** of the `MANUAL` or `SNAPSHOT` list.
        required: true
        style: simple
        explode: false
        schema:
          type: string
      responses:
        '204':
          description: No content
          content: {}
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm.lists.write
        - crm.segments.read
      - oauth2:
        - cms.membership.access_groups.write
        - crm.lists.read
      - oauth2:
        - crm.segments.read
        - crm.segments.write
      - oauth2:
        - crm.lists.read
        - crm.segments.write
      - oauth2:
        - crm.lists.read
        - crm.lists.write
      - oauth2:
        - cms.membership.access_groups.write
        - crm.segments.read
  /crm/lists/2026-03/{listId}/memberships/add:
    put:
      tags:
      - Basic
      summary: Add Records to a List
      description: 'Add the records provided to the list. Records that do not exist or that are already
        members of the list are ignored.


        This endpoint only works for lists that have a `processingType` of `MANUAL` or `SNAPSHOT`.'
      operationId: put-/crm/lists/2026-03/{listId}/memberships/add_/crm/lists/v3/{listId}/memberships/add
      parameters:
      - name: listId
        in: path
        description: The **ILS ID** of the `MANUAL` or `SNAPSHOT` list.
        required: true
        style: simple
        explode: false
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type: string
        required: true
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MembershipsUpdateResponse'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm.lists.write
        - crm.segments.read
      - oauth2:
        - cms.membership.access_groups.write
        - crm.lists.read
      - oauth2:
        - crm.segments.read
        - crm.segments.write
      - oauth2:
        - crm.lists.read
        - crm.segments.write
      - oauth2:
        - crm.lists.read
        - crm.lists.write
      - oauth2:
        - cms.membership.access_groups.write
        - crm.segments.read
  /crm/lists/2026-03/{listId}/memberships/add-and-remove:
    put:
      tags:
      - Basic
      summary: Add and/or Remove Records from a List
      description: 'Add and/or remove records that have already been created in the system to and/or from
        a list.


        This endpoint only works for lists that have a `processingType` of `MANUAL` or `SNAPSHOT`.'
      operationId: put-/crm/lists/2026-03/{listId}/memberships/add-and-remove_/crm/lists/v3/{listId}/memberships/add-and-remove
      parameters:
      - name: listId
        in: path
        description: The **ILS ID** of the `MANUAL` or `SNAPSHOT` list.
        required: true
        style: simple
        explode: false
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MembershipChangeRequest'
        required: true
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MembershipsUpdateResponse'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm.lists.write
        - crm.segments.read
      - oauth2:
        - cms.membership.access_groups.write
        - crm.lists.read
      - oauth2:
        - crm.segments.read
        - crm.segments.write
      - oauth2:
        - crm.lists.read
        - crm.segments.write
      - oauth2:
        - crm.lists.read
        - crm.lists.write
      - oauth2:
        - cms.membership.access_groups.write
        - crm.segments.read
  /crm/lists/2026-03/{listId}/memberships/add-from/{sourceListId}:
    put:
      tags:
      - Basic
      summary: Add All Records from a Source List to a Destination List
      description: 'Add all of the records from a *source list* (specified by the `sourceListId`) to a
        *destination list* (specified by the `listId`). Records that are already members of the *destination
        list* will be ignored. The *destination* and *source list* IDs must be different. The *destination*
        and *source lists* must contain records of the same type (e.g. contacts, companies, etc.).


        This endpoint only works for *destination lists* that have a `processingType` of `MANUAL` or `SNAPSHOT`.
        The *source list* can have any `processingType`.


        This endpoint only supports a `sourceListId` for lists with less than 100,000 memberships.'
      operationId: put-/crm/lists/2026-03/{listId}/memberships/add-from/{sourceListId}_/crm/lists/v3/{listId}/memberships/add-from/{sourceListId}
      parameters:
      - name: listId
        in: path
        description: The **ILS ID** of the `MANUAL` or `SNAPSHOT` *destination list*, which the *source
          list* records are added to.
        required: true
        style: simple
        explode: false
        schema:
          type: string
      - name: sourceListId
        in: path
        description: The **ILS ID** of the *source list* to grab the records from, which are then added
          to the *destination list*.
        required: true
        style: simple
        explode: false
        schema:
          type: string
      responses:
        '204':
          description: No content
          content: {}
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm.lists.write
        - crm.segments.read
      - oauth2:
        - cms.membership.access_groups.write
        - crm.lists.read
      - oauth2:
        - crm.segments.read
        - crm.segments.write
      - oauth2:
        - crm.lists.read
        - crm.segments.write
      - oauth2:
        - crm.lists.read
        - crm.lists.write
      - oauth2:
        - cms.membership.access_groups.write
        - crm.segments.read
  /crm/lists/2026-03/{listId}/memberships/join-order:
    get:
      tags:
      - Basic
      summary: Fetch List Memberships Ordered by Added to List Date
      description: 'Fetch the memberships of a list in order sorted by the time the records were added
        to the list.


        The `recordId`s are sorted in *ascending* order if an `after` offset or no offset is provided.
        If only a `before` offset is provided, then the records are sorted in *descending* order.


        The `after` offset parameter will take precedence over the `before` offset in a case where both
        are provided.'
      operationId: get-/crm/lists/2026-03/{listId}/memberships/join-order_/crm/lists/v3/{listId}/memberships/join-order
      parameters:
      - name: listId
        in: path
        description: The **ILS ID** of the list.
        required: true
        style: simple
        explode: false
        schema:
          type: string
      - name: after
        in: query
        description: '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.'
        required: false
        style: form
        explode: true
        schema:
          type: string
      - name: before
        in: query
        description: '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.'
        required: false
        style: form
        explode: true
        schema:
          type: string
      - name: limit
        in: query
        description: The number of records to return in the response. The maximum `limit` is 250.
        required: false
        style: form
        explode: true
        schema:
          type: integer
          format: int32
          default: 100
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiCollectionResponseJoinTimeAndRecordId'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm.segments.read
      - oauth2:
        - crm.lists.read
  /crm/lists/2026-03/{listId}/memberships/remove:
    put:
      tags:
      - Basic
      summary: Remove Records from a List
      description: 'Remove the records provided from the list. Records that do not exist or that are not
        members of the list are ignored.


        This endpoint only works for lists that have a `processingType` of `MANUAL` or `SNAPSHOT`.'
      operationId: put-/crm/lists/2026-03/{listId}/memberships/remove_/crm/lists/v3/{listId}/memberships/remove
      parameters:
      - name: listId
        in: path
        description: The **ILS ID** of the `MANUAL` or `SNAPSHOT` list.
        required: true
        style: simple
        explode: false
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type: string
        required: true
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MembershipsUpdateResponse'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm.lists.write
        - crm.segments.read
      - oauth2:
        - cms.membership.access_groups.write
        - crm.lists.read
      - oauth2:
        - crm.segments.read
        - crm.segments.write
      - oauth2:
        - crm.lists.read
        - crm.segments.write
      - oauth2:
        - crm.lists.read
        - crm.lists.write
      - oauth2:
        - cms.membership.access_groups.write
        - crm.segments.read
  /crm/lists/2026-03/{listId}/restore:
    put:
      tags:
      - Ba

# --- truncated at 32 KB (162 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/openapi/hubspot-crm-lists-api-openapi.yml