Saltar al contenido principal
PUT
/
crm
/
v3
/
lists
/
{listId}
/
memberships
/
remove
Eliminar registros de una lista
curl --request PUT \
  --url https://api.hubapi.com/crm/v3/lists/{listId}/memberships/remove \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '[
  "<string>"
]'
{
  "recordIdsMissing": [
    "789"
  ],
  "recordIdsRemoved": [
    "123",
    "456"
  ]
}

Productos compatibles

Se requiere uno de los siguientes productos o productos de ediciones superiores.
Marketing HubMarketing Hub -Gratuito
Sales HubSales Hub -Gratuito
Service HubService Hub -Gratuito
Content HubContent Hub -Gratuito
Esta API requiere uno de los siguientes ámbitos:
cms.membership.access_groups.write
crm.lists.read
crm.lists.write

Autorizaciones

Authorization
string
header
requerido

The access token received from the authorization server in the OAuth 2.0 flow.

Parámetros de ruta

listId
string
requerido

El ID de ILS de la lista "MANUAL" o "INSTANTÁNEA".

Cuerpo

application/json

The IDs of the records to remove from the list.

Respuesta

Successful response

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[]
requerido

Los ID de los registros identificados como "faltante" (por ejemplo, no existían en el portal) y, por lo tanto, no fueron "agregados" o "eliminados".

recordIdsRemoved
string[]
requerido

Los ID de los registros que fueron "eliminados" de la lista.

recordsIdsAdded
string[]
requerido
Last modified on March 30, 2026