---
title: "Announcements"
description: "Announcements: available fields, filters, associations, and API operations."
lastModified: "2026-08-21"
---

**Path:** `events/{event_id}/announcements`  
**Methods:** GET collection/record, POST, PATCH, DELETE.

**GET**

- Fields: `event-id`, `heading`, `content`, `url`, `send-as-email`, `released`, `created-at`, `updated-at`, `admin-updated-at`, `sent-to-count`, `sent-at`, `seen-by-count`, `registrant-count`, `target-list-ids`, `delivery-mode`, `scheduled-at`.  
- Filters: `released`, `delivery_mode`, `scheduled_from`, `scheduled_to`, `created_from`, `created_to`.  
- `delivery_mode` filter values: `draft`, `immediate`, `scheduled`, `sent`.  
- Associations: none.

```
GET .../announcements?delivery_mode=scheduled&scheduled_from=2026-09-01T00:00:00Z
```

**POST/PATCH inputs:** `heading`, `content`, `url`, `send_as_email`, `target_list_ids` (array), `delivery_mode`, `scheduled_at`.

```json
{
  "heading": "Welcome reception",
  "content": "Doors open at 18:00.",
  "url": "https://example.com/reception",
  "send_as_email": false,
  "target_list_ids": [401, 402],
  "delivery_mode": "scheduled",
  "scheduled_at": "2026-09-03T15:00:00Z"
}
```

`delivery_mode` accepts `draft`, `immediate`, or `scheduled`; scheduled delivery requires `scheduled_at`. `target_list_ids` is a full replacement. Every list must belong to the event; an empty array removes list-specific targeting and therefore targets all lists. Sending announcement email requires an organization-wide, unrestricted scope. Released announcements cannot be updated or deleted.