v20

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-011984401.2 MB
League: Announcements

Send a league announcement

Sends an announcement to all members of the league. Requires a personal or developer API key whose owner is currently a league ADMIN of the league in the path, with the league announcements capability enabled on the key. League API access is gated at api_pro on the league owner's plan.

post/leagues/{identifier}/announcements

Path parameters

identifierstring required

League slug or Convex league ID.

League slug or Convex league ID.

Request body

titlestring required

Announcement title.

bodystring required

Announcement body text.

Response

The announcement was sent.

successtrue required
notifiednumber required

Number of members notified by the announcement.

timestampstring required

Response generation time (ISO 8601).