A webhook tells another system about each change on your sites, within seconds. Only admins can add one.

Add a webhook

  1. In the sidebar, open Settings. Find the Webhooks and Slack card.
  2. Paste the Address that should receive the events. It must start with https:// and be reachable from the internet.
  3. Choose the Format:
    • JSON, signed: for your own code, Zapier, Make, n8n and similar tools;
    • Slack incoming webhook: one readable line per event in a Slack channel.
  4. Press Add webhook.

For JSON, copy the signing secret now. It is not shown again.

Post to Slack

  1. In Slack, create an incoming webhook for the channel you want. Slack gives you an address that starts with https://hooks.slack.com/.
  2. Add it in Notiamo with the format Slack incoming webhook.

Each line says who did what, on which site, with a link to the comment. Slack lines are in English.

What is sent

Every new comment, reply, status change and assignment, plus edits and deleted replies. Internal notes are included and marked: webhooks go to the agency, not to clients.

A JSON delivery is a POST with this body:

{
  "delivery": "a-unique-id",
  "events": [
    {
      "id": 1234,
      "event": "comment_created",
      "at": "2026-10-14T09:30:00.000Z",
      "internal": false,
      "viaAgent": false,
      "actor": { "name": "Claire Martin" },
      "site": { "id": "…", "name": "Main site" },
      "comment": { "id": "…", "number": 12, "text": "…", "page": "/pricing", "url": "https://example.com/pricing", "status": "open", "link": "https://my.notiamo.com/comments/…" }
    }
  ]
}

Other event names are reply_created, status_changed, assigned, comment_edited, reply_edited and reply_deleted. Depending on the event, it also has reply, status (from and to), assignee or mentions. Texts are cut at 500 characters; follow link for the full comment.

Check the signature

Every JSON delivery has two headers:

  • X-Notiamo-Delivery: the same id as delivery in the body;
  • X-Notiamo-Signature: sha256= followed by the HMAC-SHA256 of the raw body, made with your signing secret.

Compute the same value on your side and compare. Refuse the request if it differs.

When your server does not answer

The card shows the last delivery, the status code your server answered and how many failures in a row. Notiamo tries again: at once, then 15, 30 and 45 minutes later, then every hour. Nothing is lost while it waits. To stop deliveries, press Delete.

API keys

Notiamo’s API keys are agent tokens. They open the MCP server at https://my.notiamo.com/api/mcp, which any MCP client can use to list, read, reply to, assign and update comments. Create one in Settings › Agent tokens, read-only or full, for all sites or one. See Connect an AI agent.

To get all comments of a site as a file, open the site page and press Export CSV or Export JSON.