---
title: "Create a new announcement."
method: POST
path: "/announcements"
tags: ["Announcements"]
---

# Create a new announcement.

`POST /announcements`

Allows a moderator to create a new announcement. The announcement is initially created with a status of 'DRAFT'.

## Request body

- object
  - `announcement_text` string, required — The content of the announcement.
  - `notes` string — Optional notes about the announcement.
  - `user_id` integer — The ID of the user who is creating the announcement.

## Response `201`

Announcement created successfully. The response includes the created announcement details.

- object
  - `announcement_id` integer — The unique identifier of the announcement.
  - `created_at` string, date-time — The timestamp when the announcement was created.
  - `announcement_text` string — The content of the announcement.
  - `notes` string — Optional notes about the announcement.
  - `user_id` string — The ID of the user who created the announcement.
  - `status` string — The status of the announcement.

## Other responses

- `400` — Validation error. This can occur if the request body does not match the expected format.
- `500` — Internal server error.

---

[API](https://skmtc.net/archives/apis/catalog-api.md) · [All operations](https://skmtc.net/archives/apis/catalog-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/archives/catalog-api/revisions/cafec81df996/schema)