---
title: "Add users to a manually managed audience segment"
method: PUT
path: "/api/segments/{id}/add_users"
tags: ["segments"]
---

# Add users to a manually managed audience segment

`PUT /api/segments/{id}/add_users`

This endpoint allows the client to add users in bulk to an audience segment specified by ID.

Successes are users that were included in the segment (even if they were already in it), and failures are users that could not be added to the segment.

## Path parameters

- `id` integer, required

## Request body

- SegmentUserIds
  - `user_ids` integer[]

## Response `200`

Result of adding the users to the segment.

## Other responses

- `401` — Unauthorized
- `404` — Audience Segment Not Found
- `422` — Unprocessable Entity

## Changes

- **2026-07-13** (v1) `7db6ba099285` — 4 breaking
  - removed the media type `application/json` for the response with the status `200`
  - removed the media type `application/json` for the response with the status `401`
  - removed the media type `application/json` for the response with the status `404`
  - removed the media type `application/json` for the response with the status `422`
- **2026-05-28** (v1) `6550ad7be94f` — 4 info
  - added the media type `application/json` for the response with the status `200`
  - added the media type `application/json` for the response with the status `401`
  - added the media type `application/json` for the response with the status `404`
  - added the media type `application/json` for the response with the status `422`
- **2026-03-03** (v1) `c9e7662755c2` — 4 breaking
  - removed the media type `application/json` for the response with the status `200`
  - removed the media type `application/json` for the response with the status `401`
  - removed the media type `application/json` for the response with the status `404`
  - removed the media type `application/json` for the response with the status `422`
- …earlier changes not shown

[Full history](https://skmtc.dev/forem/apis/forem-api-v1/changes/api/segments/:id/add_users/put.md)

---

[API](https://skmtc.dev/forem/apis/forem-api-v1.md) · [All operations](https://skmtc.dev/forem/apis/forem-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/forem/forem-api-v1/revisions/7db6ba099285/schema)