Htmlvault Com Webhooks

generated: '2026-11-11'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://htmlvault.com/docs/webhooks
sources:
- https://htmlvault.com/docs/webhooks
description: HTMLvault can POST a signed JSON notification to your server whenever something happens to a link — created, viewed, updated, expired
  — or when your tracked‑view usage crosses a threshold.
events:
- event: link.created
  description: Fires when an authenticated upload creates a link — from the web app, the REST API, or the MCP create_link tool.
- event: link.updated
  description: Fires when a link’s HTML is replaced in place — from the dashboard editor, the REST PATCH, or the MCP update_link tool.
- event: link.viewed
  description: Fires on each view of a link you own, with per‑view detail captured at view time; repeats on every view and includes fields to
    filter first‑open signals.
- event: link.expired
  description: Fires when the retention cron purges a link’s content, indicating the reason (expiry or retention).
- event: usage.threshold
  description: Fires from the daily usage cron, at most once per billing period, when your tracked‑view usage crosses your configured alert threshold.
- event: recipient.created
  description: Fires when per‑recipient tracked URLs are minted for a link; a single delivery contains the full minted list.
- event: recipient.viewed
  description: Fires on each view through a recipient‑tracked URL, in addition to link.viewed, with the same repeat‑visit behavior and first‑open
    fields.
delivery:
  content_type: application/json POST with envelope {"id","event","timestamp","data"… }
note: Subscribe to specific events or to * (all) when registering an endpoint. Seven events fire today (the list above). Up to 5 endpoints on
  Pro, 20 on Teams/Enterprise; each endpoint has its own signing secret.
docs: https://htmlvault.com/docs/webhooks