Create event announcement

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

titlestring

Title; optional, no length limit.

contentstringrequired

Body; required on create. No length limit.

targetStatesstring[]

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[]

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

sendEmailboolean

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

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"
}