---
title: "Bulk update subscribers"
method: PATCH
path: "/audience/bulk"
tags: ["Audience"]
---

# Bulk update subscribers

`PATCH /audience/bulk`

## Request

- Base URL: `https://doomscrollr.com/api/v1`
- URL: `https://doomscrollr.com/api/v1/audience/bulk`
- Auth: HTTP bearer

Update up to 500 audience members owned by the API key account. Supports bounced/unsubscribed/spam flags and tag replace/append/remove.

## Request body

- object
  - `ids` integer[], required
  - `tags` string: Comma-separated tags, or array in JSON clients
  - `tag_mode` 'replace' | 'append' | 'remove'
  - `bounced` boolean
  - `unsubscribed` boolean
  - `spam` boolean

## Response `200`

Bulk update result

- object
  - `updated` integer
  - `deleted` integer
  - `ids` integer[]
  - `missing_ids` integer[]

## Other responses

- `429`: Monthly API rate limit exceeded

---

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