Webhooks for every comment event
Give HTMLAnnotate an address and it sends a JSON message there for every new comment, reply, resolved comment, approval and change request. Each one is signed, so you know it came from us.
x-htmlannotate-event: comment.created x-htmlannotate-signature: sha256=5f1c9a… { "event": "comment.created", "at": "2026-11-20T10:42:07.512Z", "page": { "slug": "copperleaf-home", "title": "Copperleaf · Home", "reviewUrl": "https://htmlannotate.com/v/copperleaf-home" }, "by": "Maya Chen", "comment": { "number": 4, "text": "Can the headline mention same-week delivery?", "element": "heading \"Small-batch coffee\"", "screen": "Desktop" } }
What you get
What gets sent. Five events, each as signed JSON.
- New comments
With the comment number, the screen size, the element it is pinned to and the comment itself.
- Replies
When you, a teammate or a reviewer answers a comment.
- Resolved comments
When a comment is marked done.
- Approvals
When a reviewer approves a version of the page.
- Change requests
When a reviewer asks for changes instead of approving.
Set it up
Connect Webhooks in 4 steps.
- 1
In HTMLAnnotate, open Integrations, then Webhooks.
- 2
Paste the https address that should receive the messages and press Save.
- 3
Copy the signing secret shown under the address, to check each message.
- 4
Press Send a test. You get a message with the event
test.
Messages time out after 6 seconds, so reply quickly and do slow work afterwards.
Open Integrations in the app
Check the signature
Know each message came from us. Compare the signature header with your own HMAC of the raw body.
import crypto from "node:crypto"; function isFromHTMLAnnotate(rawBody, header, secret) { const mine = "sha256=" + crypto.createHmac("sha256", secret).update(rawBody).digest("hex"); return header.length === mine.length && crypto.timingSafeEqual(Buffer.from(header), Buffer.from(mine)); }
Webhooks questions.
Pro is $15 a month, or $12 a month billed yearly. Team is $40 a month for 5 people, or $32 billed yearly.
See pricingWhich events are sent?
comment.created, comment.replied, comment.resolved, page.approved and page.changes_requested, plus test when you press Send a test.
How do I check a message is real?
Each message has an x-htmlannotate-signature header: sha256= followed by an HMAC SHA-256 of the raw body, made with your signing secret. Make the same HMAC on your side and compare.
Can I use Zapier, Make or n8n?
Yes. Each of them can give you a webhook address to paste here. See the Zapier, Make and n8n pages for the steps.
More integrations
Works with the rest of your tools. Connect as many as you like.
Pin feedback to the page. Send it to Webhooks.
Free to start. Integrations are on Pro and Team.