---
title: "Bulk subscribe / unsubscribe / delete / suppress"
method: POST
path: "/v1/contacts/bulk"
tags: ["Contacts"]
---

# Bulk subscribe / unsubscribe / delete / suppress

`POST /v1/contacts/bulk`

## Request

- Base URL: `https://api.volanea.com`
- URL: `https://api.volanea.com/v1/contacts/bulk`
- Auth: HTTP bearer

Apply one action to up to 10,000 addresses. `suppress` adds addresses to the do-not-send list even if no contact exists.

## Request body

- object
  - `action` 'subscribe' | 'unsubscribe' | 'delete' | 'suppress', required
  - `emails` string[], required

## Response `200`

How many contacts were affected.

- object
  - `action` string, required
  - `affected` integer, required

## Other responses

- `401`: Missing or invalid API key.
- `422`: Request validation failed (code `validation_error`, 422).

---

[API](https://skmtc.dev/volanea/apis/volanea-api.md) · [All operations](https://skmtc.dev/volanea/apis/volanea-api/llms.txt) · [OpenAPI document](https://skmtc.dev/volanea/apis/volanea-api/revisions/9e187ae84fda?raw)