Webhook dey tell another system about each change for your projects, within seconds. Only admins fit add one.
Add webhook
- For di sidebar, open Settings › AI agents. Find di Webhooks and Slack card.
- Paste di Address wey go receive di events. E must start with
https://and internet must fit reach am. - Choose di Format:
- JSON, signed: for your own code, Zapier, Make, n8n and similar tools;
- Slack incoming webhook: one readable line for each event inside Slack channel.
- Press Add webhook.


For JSON, copy di signing secret now. Dem no go show am again.
Post to Slack
- For Slack, create incoming webhook for di channel wey you want. Slack go give you address wey start with
https://hooks.slack.com/. - Add am for Notiamo with di format Slack incoming webhook.
Each line dey talk who do wetin, for which project, with link to di comment. Slack lines dey for English.
Wetin dem dey send
Every new comment, reply, status change and assignment, plus edits and replies wey dem delete. Internal notes dey inside and dem get mark: webhooks dey go to di agency, no be to clients.
JSON delivery na POST with dis 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" },
"project": { "id": "…", "name": "Main website" },
"comment": { "id": "…", "number": 12, "type": "highlight", "title": null, "text": "…", "page": "/pricing", "url": "https://example.com/pricing", "status": "open", "link": "https://my.notiamo.com/comments/…" }
}
]
}
Other event names na reply_created, status_changed, assigned, comment_edited, reply_edited and reply_deleted. Depending on di event, e also get reply, status (from and to), assignee or mentions. Dem dey cut texts for 500 characters; follow link for di full comment.
Job report wey move forward dey send job.state_changed, with job: from and to (draft, ready, article_waiting, changes_requested, approved or posts_delivered), commentId and number. Move back to draft dem dey send am too; Slack dey leave am out.
Check di signature
Every JSON delivery get two headers:
X-Notiamo-Delivery: di same id asdeliveryinside di body;X-Notiamo-Signature:sha256=followed by di HMAC-SHA256 of di raw body, wey dem make with your signing secret.
Work out di same value for your side and compare am. Refuse di request if e different.
When your server no answer
Di card dey show di last delivery, di status code wey your server answer and how many failures dey one after di other. Notiamo dey try again: at once, then 15, 30 and 45 minutes later, then every hour. Nothing go loss while e dey wait. To stop deliveries, press Delete.
API keys
Di API keys of Notiamo na agent keys. Dem dey open di MCP server for https://my.notiamo.com/api/mcp, wey any MCP client fit use to list, read, reply, assign and update comments. Create one inside Settings › AI agents › Agent keys, read-only or full, for all projects or one. MCP client wey support sign-in (OAuth) no need key. See Connect an AI agent.
To get all comments of project as file, open di project page and press Export CSV or Export JSON.