Create event announcement (Admin)

POST/manage/events/:eventId/announcements

Create an announcement for participants. Requires the announcementsWrite permission. Use targetStates / targetTicketIds to narrow the audience (defaults to CONFIRMED + CHECKED_IN entrants across all tickets). sendEmail defaults to true, so omitting it sends email to the targeted recipients.

Auth	Login required

Path parameters

eventIdstringrequired

Event ID or slug.

Request body

titlestringoptional

Title; optional, no length limit.

contentstringrequired

Body; required on create. No length limit.

targetStatesstring[]optional

Entry states to target; at least one of UNUSED / PENDING / AWAITING_PAYMENT / CONFIRMED / CHECKED_IN. Defaults to ["CONFIRMED", "CHECKED_IN"] when omitted. An empty array is a validation error.

targetTicketIdsstring[]optional

Ticket IDs to target; omitting it or passing an empty array targets all tickets.

sendEmailbooleanoptional

Whether to notify recipients by email. Defaults to true — omitting it sends email. Pass false explicitly to skip email.

Response

Returns Announcement.

Request

curl https://api.4s.link/manage/events/EVENT_ID/announcements \
  -X POST \
  -H "Authorization: Bearer 4s_at_..." \
  -H "Content-Type: application/json" \
  -d '{
  "title": "会場変更のお知らせ",
  "content": "...",
  "targetStates": ["UNUSED"],
  "sendEmail": false
}'

Example response

{
  "id": "an1a2b3c-...",
  "title": "会場変更のお知らせ",
  "content": "...",
  "targetStates": ["UNUSED", "CHECKED_IN"],
  "targetTicketIds": [],
  "createdAt": "2026-08-18T00:00:00.000Z"
}