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.

Pro and TeamSet up in about two minutesReviewers never need an account

POST your-server.com/hooks/htmlannotate
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.

Set it up

Connect Webhooks in 4 steps.

  1. 1

    In HTMLAnnotate, open Integrations, then Webhooks.

  2. 2

    Paste the https address that should receive the messages and press Save.

  3. 3

    Copy the signing secret shown under the address, to check each message.

  4. 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
The Webhooks panel on the HTMLAnnotate Integrations page with a webhook address and the signing secret
The Webhooks panel in the app, once it is connected.

Check the signature

Know each message came from us. Compare the signature header with your own HMAC of the raw body.

Node.js
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 pricing
Which 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.

All integrations

Pin feedback to the page. Send it to Webhooks.

Free to start. Integrations are on Pro and Team.