Events · Samenwerking
announcement.read
Aankondiging gelezen
Een ontvanger heeft het lezen van een aankondiging met verplichte lectuur bevestigd.
- Objecttype
- announcement
- Geleverd aan
- Webhooks die het object mogen zien: op basis van rol, dataprofiel en collecties
Payload
idstringverplichtID van het event (
evt_…), ook meegestuurd als headerwebhook-id. Gebruik die om dubbele leveringen te negeren.typestringverplichtToegestane waarden:
announcement.readcreated_atstring (date-time)verplichtWanneer de wijziging plaatsvond (UTC).
org_idintegerverplichtapi_versionstringverplichtContractversie van het schema van
data.sequenceintegerVolgnummer van de levering binnen de webhook (ontbreekt bij een testevent).
payloadstringverplichtthinbetekent geendata: lees het object via de API.Toegestane waarden:
fullthindataobjectVelden
user_idintegerverplichtWie het lezen heeft bevestigd.
testbooleanverplichtEen testevent, verstuurd door
POST /v1/webhooks/{webhook_id}/test.
Voorbeeldlevering
{
"id": "evt_0123456789abcdef0123456789abcdef",
"type": "announcement.read",
"created_at": "2026-10-24T10:00:03Z",
"org_id": 1,
"api_version": "1.62.0",
"sequence": 1042,
"object": {
"type": "announcement",
"id": "12"
},
"payload": "full",
"data": {
"announcement": {
"id": 12,
"card_id": "c_9f2e41"
},
"user_id": 11
},
"test": false
}Events ontvangen
Elke levering is een POST-request met deze JSON-body naar het ontvangstadres van je webhook. Controleer de header webhook-signature (Standard Webhooks) voordat je de body vertrouwt, antwoord binnen een paar seconden met een 2xx-status en doe het werk daarna. Leveringen aan één webhook behouden de volgorde van de events; een mislukte levering wordt met steeds langere pauzes opnieuw geprobeerd.
Er kunnen op elk moment nieuwe eventtypes en nieuwe velden bij komen: sla de types en velden over die je niet kent.