---
title: "Archive a batch of leads by ID"
method: POST
path: "/crm/v3/objects/leads/batch/archive"
tags: ["Batch"]
---

# Archive a batch of leads by ID

`POST /crm/v3/objects/leads/batch/archive`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/crm/v3/objects/leads/batch/archive`
- Auth: none required

Archive multiple leads by their IDs in a single request, moving them to the recycling bin.

## Request body

- BatchInputSimplePublicObjectId: Represents a batch input payload containing a list of simple public object IDs. This component is used when performing batch operations on multiple objects within HubSpot.
  - `inputs` SimplePublicObjectId[], required: An array of simple public object IDs to be processed in the batch operation.
    - `id` string, required: The unique ID of the object.

## Response `204`

No content

## Other responses

- `default`: An error occurred.

## Changes

- **2026-09-22** (v3) `6af2ebb37fe0`: 1 info
  - the endpoint scheme security `oauth2` was removed from the API
- **2026-07-13** (v3) `2a8d409d7f40`: 1 info
  - endpoint added
- **2026-07-13** (v3) `ef081db8be86`: 1 breaking
  - api path removed without deprecation
- **2026-04-15** (v3) `03f92a212086`: 5 info
  - the endpoint scheme security `app_cookie` was removed from the API
  - the endpoint scheme security `hapikey` was removed from the API
  - the endpoint scheme security `internal_cookie` was removed from the API
  - the endpoint scheme security `private_apps` was removed from the API
  - …1 more
- **2026-04-11** (v3) `655c7ff9ed28`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hubspot/apis/crm-leads/changes/crm/v3/objects/leads/batch/archive/post.md)

---

[API](https://skmtc.dev/hubspot/apis/crm-leads.md) - [All operations](https://skmtc.dev/hubspot/apis/crm-leads/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/crm-leads/revisions/a8b7be0524f9?raw)