visitor.erased
A visitor's personal data is erased, through the API, the console or a data subject request. Delete any copy you hold of this visitor's personal data.
Agoo sends this as a signed POST to every enabled endpoint subscribed to visitor.erased (or *). Verify the
signature, return any 2xx within 15 seconds, and de-duplicate on webhook-id.
Header Parameters
The event's ID. It is the same on every attempt and redelivery, so use it to de-duplicate.
^evt_[0-7][0-9a-hjkmnp-tv-z]{25}$"evt_01m4ww0ezgf2bryg9gxb2gbewx"When this attempt was signed, in Unix seconds. Reject the request if it is more than 5 minutes from your clock.
^[0-9]+$One or more space-separated signatures, each v1,<base64>: the base64 HMAC-SHA256 of
{webhook-id}.{webhook-timestamp}.{raw body}, keyed with the base64-decoded part of your whsec_ secret.
During a secret rotation there are two. Accept the request if any one matches.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
An event about a visitor record.
Response Body
Example Requests
/visitor.erasedperson.reactivated Webhook
A deactivated person is reactivated. They're back in the directory and can host and clock in again; if deactivating them removed their sign-in, it's back too. Agoo sends this as a signed `POST` to every enabled endpoint subscribed to `person.reactivated` (or `*`). Verify the signature, return any `2xx` within 15 seconds, and de-duplicate on `webhook-id`.
List audit events GET
Returns entries from your organisation's audit trail, newest first: changes, exports and views of personal data, by people, API keys, OAuth apps, kiosks and Agoo itself. The trail is append-only and hash-chained: each entry's `previous_hash` is the `hash` of the entry before it. Returns entries from your plan's audit-trail period (3 years on Pro, up to 7 years on Enterprise). Moving to a lower plan doesn't delete older entries: they're kept, hidden, and come back when you move up. **Scope:** `audit:read` · **Plan:** Pro and Enterprise in live mode; every plan in test mode.