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

# Create Announcement

`POST /organizations/{org_id}/announcements`

Staff broadcast. Body: {title?, body, group_ids?: [..], important?} —
no group_ids means org-wide; several ids fan out one announcement per
section (Classroom multi-class 'For' pattern). `important` is the only
delivery control a teacher gets, and it is about the MESSAGE, not the
channel: it reaches students on the daily digest right away.

The audience is authorized by `_require_announcement_scope`, not by
`_require_staff_role`: "is a teacher somewhere in this school" was standing
in for "may address these people", which is the same substitution
`_require_group_staff` was written to end on the section endpoints.

## 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/78f314acd8bf/schema)