Link

Link lifecycle and configuration events with their signed payload contract.

Scope overview

This page lists every Link event available to workspace webhooks. Use the exact event name in your receiver; the same activity is also recorded in Logs. Each row identifies the affected record.

Event list

ActionEvent nameRecord ID
Created<link_id>
Destination updated<link_id>
Collection changed<link_id>
Tags changed<link_id>
Partner changed<link_id>
UTM updated<link_id>
Preview updated<link_id>
Access updated<link_id>
Targeting updated<link_id>
Expiry updated<link_id>
QR settings updated<link_id>
Notes updated<link_id>
External ID updated<link_id>
Tenant ID updated<link_id>
Deleted<link_id>

Event payload

Every selectable event uses the same JSON Schema 1.0 payload. Only type and data.id vary by event. The payload identifies the event and affected record; it does not include a record snapshot. Fetch more detail through the relevant API when available.

Code json
{
	"id": "<event_id>",
	"type": "link.created",
	"created": "2026-09-23T10:30:00.000Z",
	"data": {
		"id": "<link_id>",
		"workspaceId": "<workspace_id>"
	}
}

Data fields

FieldTypeMeaning
idstringStable event ID; also sent in the webhook-id header.
typestringExact event name from the catalog.
createdstringEvent time in ISO 8601 UTC format.
data.idstringPublic ID of the affected record.
data.workspaceIdstringPublic ID of the workspace that owns the event.