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

# Add Records to a List

`PUT /crm/v3/lists/{listId}/memberships/add`

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

## Path parameters

- `listId` string, required

## Request body

- string[]

## 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)