Webhooks
Get notified when todos or boards change. Each webhook can cover your whole account or only specific boards, listens to the events you pick, and includes who did it plus a before and after changelog.
Your webhooks
Events
todo.createdA todo was createdtodo.updatedA todo's title, description, priority, due date, tags or images changedtodo.movedA todo moved to another categorytodo.completedA todo was marked as completedtodo.scrappedA todo was scrappedtodo.deletedA todo was deleted (it stays restorable in History)todo.restoredA todo was restored from Historyboard.createdA board was created (account-wide webhooks only)board.updatedA board's name, description, icon, colour or archive state changedboard.deletedA board and all its todos were deletedPayload
{
"id": "1291204012871098368",
"event": "todo.updated",
"createdAt": "2026-10-05T12:30:00.000Z",
"actor": {
"userId": "80351110224678912",
"username": "nelly",
"displayName": "Nelly",
"avatarUrl": "https://cdn.discordapp.com/avatars/…",
"via": "api:1291199911112222333",
"viaLabel": "API key “CI bot”"
},
"board": { "id": "1291200000000000001", "name": "Roadmap", "url": "https://your-domain/boards/1291200000000000001" },
"todo": {
"id": "1291200000000000002", "number": 12, "title": "Ship webhooks",
"description": "…", "priority": "high", "state": "active",
"category": "In progress", "tags": ["backend"], "dueAt": null,
"attachments": [], "url": "https://your-domain/todo/1291200000000000002"
},
"changes": [
{ "field": "priority", "label": "Priority", "before": "medium", "after": "high" },
{ "field": "description", "label": "Description", "before": "Old text", "after": "New text" }
]
}AuthorizationBearer <your API key>X-Atlas-EventThe event name, e.g. todo.updatedX-Atlas-DeliveryUnique delivery id (same as the payload id)X-Atlas-Signaturesha256=<HMAC-SHA256 of the raw body, keyed with your API key>Content-Typeapplication/jsonVerifying requests
import crypto from "node:crypto";
// Express-style handler. `raw` is the unparsed request body string.
function verify(raw, headers, apiKey) {
if (headers.authorization !== `Bearer ${apiKey}`) return false;
const expected = "sha256=" + crypto.createHmac("sha256", apiKey).update(raw).digest("hex");
const given = headers["x-atlas-signature"] ?? "";
return given.length === expected.length && crypto.timingSafeEqual(Buffer.from(given), Buffer.from(expected));
}