Sign in
Webhooks

Create Webhook

Set up a webhook to monitor for events.<br> We do not have a dedicated IP address for webhooks. We use our domain name and dynamic addressing.

post/v2/team/{team_id}/webhook

Path parameters

team_idnumber required
Example:123

Workspace ID

Request body

endpointstring required
eventsstring[] required

See documentation for available event options. Use * to subscribe to all events.

space_idinteger
folder_idinteger
list_idinteger
task_idstring

Example request

{
  "endpoint": "https://yourdomain.com/webhook",
  "events": [
    "taskCreated",
    "taskUpdated",
    "taskDeleted",
    "taskPriorityUpdated",
    "taskStatusUpdated",
    "taskAssigneeUpdated",
    "taskDueDateUpdated",
    "taskTagUpdated",
    "taskMoved",
    "taskCommentPosted",
    "taskCommentUpdated",
    "taskTimeEstimateUpdated",
    "taskTimeTrackedUpdated",
    "listCreated",
    "listUpdated",
    "listDeleted",
    "folderCreated",
    "folderUpdated",
    "folderDeleted",
    "spaceCreated",
    "spaceUpdated",
    "spaceDeleted",
    "goalCreated",
    "goalUpdated",
    "goalDeleted",
    "keyResultCreated",
    "keyResultUpdated",
    "keyResultDeleted"
  ],
  "space_id": 1234,
  "folder_id": 5678,
  "list_id": 9876,
  "task_id": "abc1234"
}

Response

idstring required
webhookWebhook required— unresolved $ref

Example response

{
  "id": "4b67ac88-e506-4a29-9d42-26e504e3435e",
  "webhook": {
    "id": "4b67ac88-e506-4a29-9d42-26e504e3435e",
    "userid": 183,
    "team_id": 108,
    "endpoint": "https://yourdomain.com/webhook",
    "client_id": "QVOQP06ZXC6CMGVFKB0ZT7J9Y7APOYGO",
    "events": [
      "taskCreated",
      "taskUpdated",
      "taskDeleted",
      "taskPriorityUpdated",
      "taskStatusUpdated",
      "taskAssigneeUpdated",
      "taskDueDateUpdated",
      "taskTagUpdated",
      "taskMoved",
      "taskCommentPosted",
      "taskCommentUpdated",
      "taskTimeEstimateUpdated",
      "taskTimeTrackedUpdated",
      "listCreated",
      "listUpdated",
      "listDeleted",
      "folderCreated",
      "folderUpdated",
      "folderDeleted",
      "spaceCreated",
      "spaceUpdated",
      "spaceDeleted",
      "goalCreated",
      "goalUpdated",
      "goalDeleted",
      "keyResultCreated",
      "keyResultUpdated",
      "keyResultDeleted"
    ],
    "task_id": null,
    "list_id": null,
    "folder_id": null,
    "space_id": null,
    "health": {
      "status": "active",
      "fail_count": 0
    },
    "secret": "O94IM25S7PXBPYTMNXLLET230SRP0S89COR7B1YOJ2ZIE8WQNK5UUKEF26W0Z5GA"
  }
}

Changes