Announcement Events

Audience: company or partner. Everee sends a webhook when it publishes, edits or retracts a technical announcement: an API release, a deprecation, a maintenance notice or a security notice. Product announcements are not sent as webhooks. To read the announcements themselves, see the Announcements API guide.

Events

Event type	Sent when
`announcement.published`	An announcement is published
`announcement.updated`	A published announcement is edited. The event carries its current state and may cover several edits made close together
`announcement.retracted`	A published announcement is withdrawn. Only owners who received `announcement.published` receive it

Who receives them

Everee decides by how you work with Everee.

You are	You receive them at	Envelope
A company that uses Everee directly	The company's own webhook endpoints	Company envelope, with `companyId`
A partner that builds Everee into its own product	The partner's partner webhook endpoints, once for the partner and not once per company	Partner envelope, with `partnerId`

An owner with no enabled endpoint receives nothing. Sandbox instances receive nothing. Announcement events arrive only for announcements published after Everee switched them on; earlier announcements are available from the API.

Payload

data.object is the announcement without its full text, so the event stays small. Fetch the full text with Get an announcement using id. A retracted announcement is no longer returned by the API, so the retraction event carries enough to say what was withdrawn. Fields without a value are omitted.

Field	Type	Meaning
`id`	integer	The announcement's ID. Use it as the key
`kind`	string	Always `TECHNICAL`
`category`	string	`API_RELEASE`, `DEPRECATION`, `MAINTENANCE` or `SECURITY`
`severity`	string	`INFO`, `IMPORTANT` or `CRITICAL`
`title`	string	A headline
`summary`	string	A short description
`effectiveDate`	date	When the change takes effect, if there is a date
`sunsetDate`	date	For a deprecation, when the old behavior stops working
`affected`	string	The endpoints, versions or features it concerns
`learnMoreUrl`	string	Where the full announcement lives
`mandatory`	boolean	`true` for security notices and deprecations with a `sunsetDate`
`publishedAt`	date-time	When Everee published it, in UTC
`retractedAt`	date-time	Only on `announcement.retracted`: when it was withdrawn

Webhook event type: announcement.published (and announcement.updated, announcement.retracted).
Example data.object. The values are made up.

{
  "id": 142,
  "kind": "TECHNICAL",
  "category": "DEPRECATION",
  "severity": "IMPORTANT",
  "title": "Legacy payables endpoint retires",
  "summary": "The v0 payables endpoint stops working on 2027-04-01.",
  "effectiveDate": "2027-01-15",
  "sunsetDate": "2027-04-01",
  "affected": "POST /api/v0/payables",
  "learnMoreUrl": "https://developer.everee.com/changelog/legacy-payables",
  "mandatory": true,
  "publishedAt": "2026-11-02T15:04:05.123456Z"
}

The object is also defined as a JSON Schema.

Handling them

Events can arrive more than once and out of order. Treat id as the key, and treat the latest event for an id as its state. If you receive announcement.retracted for an announcement, remove or mark it. See Implementing a Webhook Handler.