---
title: "Preview Announcement Audience"
method: POST
path: "/organizations/{org_id}/announcements/preview"
tags: ["organizations", "organizations"]
---

# Preview Announcement Audience

`POST /organizations/{org_id}/announcements/preview`

How many students this reaches, and on which channels, BEFORE sending.

POST rather than GET because the audience is a list of group ids and a
teacher can pick a dozen sections. Body: {group_ids?: [..]}.

Gated by the SAME rule as the send. A preview that happily counts an
audience the send will refuse is how the composer came to advertise "Goes
to 25 people" to a teacher of twelve.

## Path parameters

- `org_id` string, required

## Headers

- `authorization` string, nullable

## Request body

- object

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/fluentea/apis/aurqa-language-learning-platform-refactored.md) · [All operations](https://skmtc.dev/fluentea/apis/aurqa-language-learning-platform-refactored/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fluentea/aurqa-language-learning-platform-refactored/revisions/61a1443b4f81/schema)