---
title: "Archive a batch of contacts"
method: POST
path: "/crm/objects/2026-03/contacts/batch/archive"
tags: ["Batch"]
---

# Archive a batch of contacts

`POST /crm/objects/2026-03/contacts/batch/archive`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/crm/objects/2026-03/contacts/batch/archive`
- Auth: none required

Archive a batch of contacts by ID. Archived contacts can be restored within 90 days of deletion. Learn more about the [data impacted by contact deletions](https://knowledge.hubspot.com/privacy-and-consent/understand-restorable-and-permanent-contact-deletions) and how to [restore archived records](https://knowledge.hubspot.com/records/restore-deleted-records).

## 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** (2026-03) `27aa774222cc`: 1 info
  - the endpoint scheme security `oauth2` was removed from the API
- **2026-04-15** (2026-03) `2cc6f4ba304e`: 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

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

---

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