Task webhook

The Task webhook is described below. Note that webhooks deliver only the event notification. The actual data must be read using the provided event details.

Webhook Subject: TASK

Supported events:

  • CREATE
  • UPDATE
  • DELETE

Summary

Webhook for updates related to tasks on the platform

Description

Listen to updates to tasks to create rich experiences like verifying a task priority based on a customer support case using the company profile to assign a default priority.

The task also has an associated change log which can be fetched separately for the change history.

Task updates like adding a dependency can be used to automate workflow steps based on the dependency status.

Another common scenario for task automation is when a task is marked done then it's dependent tasks can be marked as ready for work.

Example

Below is an example webhook payload (pretty printed):

{
  "trigger" : {
    "urn" : "6099cb4a-00a5-4e08-8a8d-c570254b5757",
    "owner" : {
      "urn" : "32a90f18-aaa0-4bdc-a63e-4efd2e16c28c",
      "url" : "/n/v1/company/32a90f18-aaa0-4bdc-a63e-4efd2e16c28c"
    },
    "timestamp" : "2026-05-29T13:45:32",
    "subject" : "TASK",
    "event" : "CREATE",
    "targetUrn" : "fdcb0191-8408-4132-abf7-57adeafe59e2"
  },
  "subscription" : {
    "urn" : "691be1de-09df-411d-ad4a-3cc7ec771cd4",
    "subject" : "TASK",
    "event" : "ALL",
    "destinationUrl" : "https://example.com/webhooks/task",
    "auth" : "BEARER",
    "expirationTimestamp" : "2026-06-28T13:45:32",
    "eventsPerMinute" : 500
  },
  "v1" : {
    "urn" : "fdcb0191-8408-4132-abf7-57adeafe59e2",
    "url" : "/n/v1/task/fdcb0191-8408-4132-abf7-57adeafe59e2"
  }
}