---
title: "Add and/or Remove Records from a List"
method: PUT
path: "/crm/v3/lists/{listId}/memberships/add-and-remove"
tags: ["Basic"]
---

# Add and/or Remove Records from a List

`PUT /crm/v3/lists/{listId}/memberships/add-and-remove`

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`.

## Path parameters

- `listId` string, required

## Request body

- MembershipChangeRequest — The IDs of the records to add and/or remove from a list.
  - `recordIdsToAdd` string[], required
  - `recordIdsToRemove` string[], required

## Response `200`

successful operation

- MembershipsUpdateResponse — The IDs of the records that were `added`, `removed`, and/or found to be `missing` as a result of the membership update request.
  - `recordIdsMissing` string[], required — The IDs of the records that were `missing` (e.g. did not exist in the portal) and so were not `added` or `removed`.
  - `recordIdsRemoved` string[], required — The IDs of the records that were `removed` from the list.
  - `recordsIdsAdded` string[], required

## Other responses

- `default` — An error occurred.

---

[API](https://skmtc.net/hubspot/apis/crm-lists.md) · [All operations](https://skmtc.net/hubspot/apis/crm-lists/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hubspot/crm-lists/revisions/2ba1203b03a0/schema)