Task webhooks — get notified when a task changes
A task webhook is a URL you register with 0nTask so that whenever a task is created, updated, completed or deleted, 0nTask sends an HTTP POST to that URL describing what happened.
Webhooks are how the task manager talks outward — into a CRM, a Slack channel, a spreadsheet, or your own application — without anything having to poll for changes.
Events
task.createdtask.updatedtask.completedtask.deleted
Payload
{
"event": "task.created",
"task": { "id": "task_…", "title": "Call the roofer back", "status": "todo", "priority": "high" },
"sent_at": "2026-07-30T12:00:00.000Z"
}Verifying a delivery
Set a secret when you register the webhook and every delivery carries X-0nTask-Signature: sha256=<hmac>, an HMAC-SHA256 of the raw request body. Recompute it with your secret and compare before trusting the payload.
FAQ
What events can I subscribe to?
task.created, task.updated, task.completed and task.deleted. You can subscribe to all of them or a subset.
How do I verify a webhook really came from 0nTask?
Set a secret when registering the webhook. Every delivery then carries X-0nTask-Signature: sha256=… which is an HMAC-SHA256 of the raw request body using that secret. Recompute it and compare.
What happens if my endpoint is down?
The delivery is recorded as failed and the failure count on that webhook increases. A failing receiver never slows down or breaks the API call that triggered the event.
What does the payload look like?
A flat JSON object: { event, task, sent_at }. The task object matches what the REST API returns, so you can handle both with the same code.