Dark
Get help in the API Community

Webhooks

Webhooks allow you to subscribe to notifications about changes in Wrike instead of having to rely on periodic polling. When webhooks are in place, a small package of information (“payload”) is sent to your HTTP endpoint when specific changes occur.

We support the following scopes for webhooks:

  1. Folder webhooks - Fire notifications about changes to tasks within a single folder or project. You can subscribe to folder/project individually, or use “recursive” webhooks to subscribe to folder/project and its subfolders/subprojects.

  2. Account webhooks - Fire notifications about task, folder, and project-related events in the Account. Includes changes to all tasks that are shared with you in the account.

  3. Space webhooks - Fire notifications about changes to tasks, folders, and projects within a single space.

API Methods

REST-style API methods allow you to create webhooks, get lists of your webhooks and their states, update webhook states, and delete webhooks.

Create Webhooks

  • [POST] /folders/{folderId}/webhooks — Creates a webhook for a target folder/project.

    Parameters:

    • hookUrl - URL of the server that will receive the payload.

    • secret (optional) - Client secret to check authenticity of the events later. See Secure Webhooks section below.

    • events (optional) - Comma-separated list of events that client wants to subscribe to, in square brackets.

      Example: [AttachmentAdded,AttachmentDeleted]. If not specified, all events will be received. See supported events here.

    • recursive (optional) - Specifies whether hook should listen to events for subfolders and subprojects anywhere in the hierarchy. Default value is false, set to true for tracking all nested elements.

  • [POST] /spaces/{spaceId}/webhooks — Creates a webhook for a target space.

    Parameters:

    • hookUrl - URL of the server that will receive the payload.

    • secret (optional) - Client secret to check authenticity of the events later. See Secure Webhooks section below.

    • events (optional) - Comma-separated list of events that client wants to subscribe to, in square brackets.

      Example: [AttachmentAdded,AttachmentDeleted]. If not specified, all events will be received. See supported events here.

    • recursive (optional) - Specifies whether hook should listen to events for subfolders and subprojects anywhere in the hierarchy. Default value is false, set to true for tracking all nested elements.

  • [POST] /webhooks — Creates a webhook for a current account.

    Parameters:

    • hookUrl - URL of the server that will receive the payload.

    • secret (optional) - Client secret to check authenticity of the events later. See Secure Webhooks section below.

    • events (optional) - Comma-separated list of events that client wants to subscribe to, in square brackets.

      Example: [AttachmentAdded,AttachmentDeleted]. If not specified, all events will be received. See supported events here.

Get Webhook(s) State

  • [GET] /webhooks — Returns a list of webhooks created under the API app associated with the token used for request authorization.

  • [GET] /webhooks/{webhookId},{webhookId},... [up to 100 IDs] — Returns information for the specified webhooks.

  • The response model for these methods includes the following data for each hook: 
    webhook ID, account ID, Folder ID (optional), your server's URL and status (Active | Suspended).

Update Webhook State

  • [PUT] /webhooks/{webhookId} — Modifies the webhooks state to suspend or resume. Suspended webhooks do not send notifications.

    Parameters:

    • status = Active | Suspended

Delete Webhooks

  • [DELETE] /webhooks/{webhookId} — Deletes webhook by ID.

Sample Payloads

Below is an example of the most basic payload which can be received. This payload is sent when a new task is created (note the “eventType”):

[{
    "webhookId": "IEAAABC6JAAAABAS",
    "eventAuthorId": "KUAAABKU",
    "eventType": "TaskCreated",
    "taskId": "IEAAABC6KQAB5FKW",
    "lastUpdatedDate": "2016-10-10T11:33:28Z"
}]

Note, even single notifications are sent as JSON-array. For simplicity, we’ll write payloads as single JSON-objects in the text below.

Some payloads can contain values that designate what the data was before the change. For example, for the TaskTitleChanged event you see the old and new task title:

{
    "oldValue": "Old task title",
    "title": "New task title",
    "taskId": "IEAAABC6KQAB5FKW",
    "webhookId": "IEAAABC6JAAAABAS",
    "eventAuthorId": "KUAAABKU",
    "eventType": "TaskTitleChanged",
    "lastUpdatedDate": "2016-11-22T10:25:50Z"
}

Another example with old/new values is TaskStatusChanged:

{
    "oldStatus": "New",
    "status": "In Progress",
    "oldCustomStatusId": "IEAADQQLJMAAAAAA",
    "customStatusId": "IEAADQQLJMA7IM7A",
    "taskId": "IEAAABC6KQAB5FKW",
    "webhookId": "IEAAABC6JAAAABAS",
    "eventAuthorId": "KUAALDRX",
    "eventType": "TaskStatusChanged",
    "lastUpdatedDate": "2016-11-22T11:09:58Z"
}

Note that custom field values are represented in the form of JSON string, so when custom field has text type, it will be wrapped in quotes:

{
    "customFieldId": "IEAAABDGJUAAAAA6",
    "oldValue": "\"old text\"",
    "value": "\"new value\"",
    "taskId": "IEAAABDGKQAB5FLY",
    "webhookId": "IEAAABDGJAAAABA2",
    "eventAuthorId": "KUAAABLA",
    "eventType": "TaskCustomFieldChanged",
    "lastUpdatedDate": "2024-09-05T07:33:24Z"
}

For events related to task child entities, (that is, attachments), payload will contain corresponding entity ID. Example is AttachmentAdded event:

{
    "webhookId": "IEAAABC6JAAAABAS",
    "eventAuthorId": "KUAALDRX",
    "eventType": "AttachmentAdded",
    "lastUpdatedDate": "2016-10-10T11:33:28Z",
    "taskId": "IEAAABC6KQAB5FKW",
    "attachmentId": "IEAADQQLKQAKAOPD"
}

To get detailed information about the attachment, use the Get Attachments method with the ID you'd received.

Event Types

The following table lists supported webhooks events. Events on tasks, folders, projects, attachments, timelogs, and comments changes are supported. Folder events are also fired on projects.

EVENT

DESCRIPTION

OLD VALUE

TaskCreated

Fired when a user creates a new task. It's also fired for creating task-based work items and submitting request forms.

{
    "webhookId": "IEAAABC6JAAAABAS",
    "eventAuthorId": "KUAAABKU",
    "eventType": "TaskCreated",
    "taskId": "IEAAABC6KQAB5FKW",
    "lastUpdatedDate": "2016-10-10T11:33:28Z"
}

TaskDeleted

Fired when task is deleted

{
    "webhookId": "IEAAABC6JAAAABAS",
    "eventAuthorId": "KUAAABKU",
    "eventType": "TaskDeleted",
    "taskId": "IEAAABC6KQAB5FKW",
    "lastUpdatedDate": "2016-10-10T11:33:28Z"
}

TaskTitleChanged

Fired when a task title changes

{
    "oldValue": "Old task title",
    "title": "New task title",
    "taskId": "IEAAABC6KQAB5FKW",
    "webhookId": "IEAAABC6JAAAABAS",
    "eventAuthorId": "KUAAABKU",
    "eventType": "TaskTitleChanged",
    "lastUpdatedDate": "2016-11-22T10:25:50Z"
}

TaskImportanceChanged

Fired when a task importance changes

{
    "oldValue": "Normal",
    "importance": "High",
    "taskId": "IEAAABC6KQAB5FKW",
    "webhookId": "IEAAABC6JAAAABAS",
    "eventAuthorId": "KUAAABKU",
    "eventType": "TaskImportanceChanged",
    "lastUpdatedDate": "2016-11-22T10:25:50Z"
}

TaskStatusChanged

Fired when a task status changes

{
    "oldStatus": "New",
    "status": "In Progress",
    "oldCustomStatusId": "IEAADQQLJMAAAAAA",
    "customStatusId": "IEAADQQLJMA7IM7A",
    "taskId": "IEAAABC6KQAB5FKW",
    "webhookId": "IEAAABC6JAAAABAS",
    "eventAuthorId": "KUAALDRX",
    "eventType": "TaskStatusChanged",
    "lastUpdatedDate": "2016-11-22T11:09:58Z"
}

TaskDatesChanged

Fired when start, finish dates, duration, or the “Work on weekends” flag is changes

{
    "oldValue": {
        "type": "Backlog",
        "workOnWeekends": false
    },
    "dates": {
        "type": "Planned",
        "startDate": "2024-09-02T09:00:00",
        "duration": 960,
        "dueDate": "2024-09-03T17:00:00",
        "workOnWeekends": false
    },
    "taskId": "IEAAABDBKQAB5FK7",
    "webhookId": "IEAAABDBJAAAABAV",
    "eventAuthorId": "KUAAABKX",
    "eventType": "TaskDatesChanged",
    "lastUpdatedDate": "2024-09-05T07:19:37Z"
}

TaskParentsAdded

Fired when a task is added to a folder, project or space

{
    "addedParents": [
        "IEAAABDCI4AB5FLD",
        "IEAAABDCI4AB5FLE"
    ],
    "taskId": "IEAAABDCKQAB5FLC",
    "webhookId": "IEAAABDCJAAAABAW",
    "eventAuthorId": "KUAAABKY",
    "eventType": "TaskParentsAdded",
    "lastUpdatedDate": "2024-09-05T07:22:25Z"
}

TaskParentsRemoved

Fired when a task is removed from a folder, project or space

{
    "removedParents": [
        "IEAAABDCI4AB5FLD",
        "IEAAABDCI4AB5FLE"
    ],
    "taskId": "IEAAABDCKQAB5FLC",
    "webhookId": "IEAAABDCJAAAABAW",
    "eventAuthorId": "KUAAABKY",
    "eventType": "TaskParentsRemoved",
    "lastUpdatedDate": "2024-09-05T07:22:25Z"
}

TaskResponsiblesAdded

Fired when any new assignee is added to a task, including all Wrike users (and collaborators) and users with pending invitations

{
    "addedResponsibles": [
        "KUAAABK2",
        "KUAAABK3"
    ],
    "taskId": "IEAAABDDKQAB5FLH",
    "webhookId": "IEAAABDDJAAAABAX",
    "eventAuthorId": "KUAAABKZ",
    "eventType": "TaskResponsiblesAdded",
    "lastUpdatedDate": "2024-09-05T07:28:37Z"
}

TaskResponsiblesRemoved

Fired when someone is unassigned from a task

{
    "removedResponsibles": [
        "KUAAABK2",
        "KUAAABK3"
    ],
    "taskId": "IEAAABDDKQAB5FLH",
    "webhookId": "IEAAABDDJAAAABAX",
    "eventAuthorId": "KUAAABKZ",
    "eventType": "TaskResponsiblesRemoved",
    "lastUpdatedDate": "2024-09-05T07:28:37Z"
}

TaskSharedsAdded

Fired when a task is shared

{
    "addedShareds": [
        "KUAAABK5",
        "KUAAABK6"
    ],
    "taskId": "IEAAABDEKQAB5FLO",
    "webhookId": "IEAAABDEJAAAABAY",
    "eventAuthorId": "KUAAABK4",
    "eventType": "TaskSharedsAdded",
    "lastUpdatedDate": "2024-09-05T07:30:39Z"
}

TaskSharedsRemoved

Fired when a task is unshared

{
    "removedShareds": [
        "KUAAABK5",
        "KUAAABK6"
    ],
    "taskId": "IEAAABDEKQAB5FLO",
    "webhookId": "IEAAABDEJAAAABAY",
    "eventAuthorId": "KUAAABK4",
    "eventType": "TaskSharedsRemoved",
    "lastUpdatedDate": "2024-09-05T07:30:39Z"
}

TaskDescriptionChanged

Fired when a task’s description is changed. Note: Notifications related to description field changes are fired with approximately a 5-minute delay.

{
    "taskId": "IEAAABDFKQAB5FLV",
    "webhookId": "IEAAABDFJAAAABAZ",
    "eventAuthorId": "KUAAABK7",
    "eventType": "TaskDescriptionChanged",
    "lastUpdatedDate": "2024-09-05T07:32:19Z"
}

TaskCustomFieldChanged

Fired when a custom field value on a custom field is changed

{
    "customFieldId": "IEAAABDGJUAAAAA6",
    "oldValue": "1",
    "value": "2",
    "taskId": "IEAAABDGKQAB5FLY",
    "webhookId": "IEAAABDGJAAAABA2",
    "eventAuthorId": "KUAAABLA",
    "eventType": "TaskCustomFieldChanged",
    "lastUpdatedDate": "2024-09-05T07:33:24Z"
}

AttachmentAdded

Fired when a new attachment is added to a task or a comment with attachment is added

{
    "webhookId": "IEAAABC6JAAAABAS",
    "eventAuthorId": "KUAALDRX",
    "eventType": "AttachmentAdded",
    "lastUpdatedDate": "2016-10-10T11:33:28Z",
    "taskId": "IEAAABC6KQAB5FKW",
    "attachmentId": "IEAADQQLKQAKAOPD"
}

AttachmentDeleted

Fired when an attachment was deleted from task or a comment with attachment was deleted

{
    "webhookId": "IEAAABC6JAAAABAS",
    "eventAuthorId": "KUAALDRX",
    "eventType": "AttachmentDeleted",
    "lastUpdatedDate": "2016-10-10T11:33:28Z",
    "taskId": "IEAAABC6KQAB5FKW",
    "attachmentId": "IEAADQQLKQAKAOPD"
}

CommentAdded

Fired when a new comment is added. Not fired for comments without text (that is, comments with attachments only).

{
    "commentId": "IEAAABDIIMAAADSG",
    "comment": {
        "text": "comment",
        "html": "<b>comment</b>"
    },
    "taskId": "IEAAABDIKQAB5FL6",
    "webhookId": "IEAAABDIJAAAABA4",
    "eventAuthorId": "KUAAABLC",
    "eventType": "CommentAdded",
    "lastUpdatedDate": "2024-09-05T07:40:40Z"
}

CommentDeleted

Fired when a comment is deleted

{
    "commentId": "IEAAABDIIMAAADSG",
    "taskId": "IEAAABDIKQAB5FL6",
    "webhookId": "IEAAABDIJAAAABA4",
    "eventAuthorId": "KUAAABLC",
    "eventType": "CommentDeleted",
    "lastUpdatedDate": "2024-09-05T07:40:40Z"
}

CreateFromBlueprintCompleted

Fired when a creation from blueprint of task/project/folder is completed

{
    "blueprintId": "IEAAABDJKQAB5FMC",
    "createdTaskGroupId": "IEAAABDJKQAB5FMD",
    "webhookId": "IEAAABDJJAAAABA5",
    "eventAuthorId": "KUAAABLD",
    "eventType": "CreateFromBlueprintCompleted",
    "lastUpdatedDate": "2024-09-05T07:46:34Z"
}

TimelogChanged

Fired when a timelog record is added, updated, or removed

{
    "timeTrackerId": "IEAAABDLJQAAAAAU",
    "type": "Added",
    "hours": "2.0",
    "taskId": "IEAAABDLKQAB5FMI",
    "webhookId": "IEAAABDLJAAAABA6",
    "eventAuthorId": "KUAAABLF",
    "eventType": "TimelogChanged",
    "lastUpdatedDate": "2024-09-05T07:48:01Z"
}

FolderCreated

Fired when a folder, project or space is created. It's also fired for creating folder or project-based work items.

{
    "folderId": "IEAAABDMI4AB5FML",
    "webhookId": "IEAAABDMJAAAABA7",
    "eventAuthorId": "KUAAABLG",
    "eventType": "FolderCreated",
    "lastUpdatedDate": "2024-09-05T07:49:34Z"
}

FolderDeleted

Fired when a folder, project or space is deleted

{
    "folderId": "IEAAABDMI4AB5FML",
    "webhookId": "IEAAABDMJAAAABA7",
    "eventAuthorId": "KUAAABLG",
    "eventType": "FolderDeleted",
    "lastUpdatedDate": "2024-09-05T07:49:34Z"
}

FolderTitleChanged

Fired when a user changes the title of a folder, project or space

{
    "oldValue": "old folder title",
    "title": "new folder title",
    "folderId": "IEAAABDNI4AB5FMO",
    "webhookId": "IEAAABDNJAAAABBA",
    "eventAuthorId": "KUAAABLH",
    "eventType": "FolderTitleChanged",
    "lastUpdatedDate": "2024-09-05T07:50:39Z"
}

FolderParentsAdded

Fired when a folder or project is added to another folder, project or space

{
    "addedParents": [
        "IEAAABDOI4AB5FMS"
    ],
    "folderId": "IEAAABDOI4AB5FMR",
    "webhookId": "IEAAABDOJAAAABBB",
    "eventAuthorId": "KUAAABLI",
    "eventType": "FolderParentsAdded",
    "lastUpdatedDate": "2024-09-05T07:52:49Z"
}

FolderParentsRemoved

Fired when a folder or project is removed from another folder

{
    "removedParents": [
        "IEAAABDOI4AB5FMS"
    ],
    "folderId": "IEAAABDOI4AB5FMR",
    "webhookId": "IEAAABDOJAAAABBB",
    "eventAuthorId": "KUAAABLI",
    "eventType": "FolderParentsRemoved",
    "lastUpdatedDate": "2024-09-05T07:52:49Z"
}

FolderSharedsAdded

Fired when a folder, project or space is shared

{
    "addedShareds": [
        "KUAAABLK",
        "KUAAABLL"
    ],
    "folderId": "IEAAABDPI4AB5FMW",
    "webhookId": "IEAAABDPJAAAABBC",
    "eventAuthorId": "KUAAABLJ",
    "eventType": "FolderSharedsAdded",
    "lastUpdatedDate": "2024-09-05T07:53:54Z"
}

FolderSharedsRemoved

Fired when a folder, project or space is unshared

{
    "removedShareds": [
        "KUAAABLK",
        "KUAAABLL"
    ],
    "folderId": "IEAAABDPI4AB5FMW",
    "webhookId": "IEAAABDPJAAAABBC",
    "eventAuthorId": "KUAAABLJ",
    "eventType": "FolderSharedsRemoved",
    "lastUpdatedDate": "2024-09-05T07:53:54Z"
}

FolderDescriptionChanged

Fired when a user changes the description of a folder or project

{
    "folderId": "IEAAABDQI4AB5FM5",
    "webhookId": "IEAAABDQJAAAABBD",
    "eventAuthorId": "KUAAABLM",
    "eventType": "FolderDescriptionChanged",
    "lastUpdatedDate": "2024-09-05T07:55:18Z"
}

FolderCommentAdded

Fired when a comment is added to a folder or project

{
    "commentId": "IEAAABDRIMAAADSY",
    "comment": {
        "text": "comment",
        "html": "<i>comment</i>"
    },
    "folderId": "IEAAABDRI4AB5FNA",
    "webhookId": "IEAAABDRJAAAABBE",
    "eventAuthorId": "KUAAABLN",
    "eventType": "FolderCommentAdded",
    "lastUpdatedDate": "2024-09-05T07:58:46Z"
}

FolderCommentDeleted

Fired when a comment is removed from a folder or project

{
    "commentId": "IEAAABDRIMAAADSY",
    "folderId": "IEAAABDRI4AB5FNA",
    "webhookId": "IEAAABDRJAAAABBE",
    "eventAuthorId": "KUAAABLN",
    "eventType": "FolderCommentDeleted",
    "lastUpdatedDate": "2024-09-05T07:58:46Z"
}

FolderAttachmentAdded

Fired when an attachment is added to a folder or project

{
    "attachmentId": "IEAAABDSIYAB5BFY",
    "folderId": "IEAAABDSI4AB5FND",
    "webhookId": "IEAAABDSJAAAABBF",
    "eventAuthorId": "KUAAABLO",
    "eventType": "FolderAttachmentAdded",
    "lastUpdatedDate": "2024-09-05T07:59:59Z"
}

FolderAttachmentDeleted

Fired when an attachment is removed from a folder or project

{
    "attachmentId": "IEAAABDSIYAB5BFY",
    "folderId": "IEAAABDSI4AB5FND",
    "webhookId": "IEAAABDSJAAAABBF",
    "eventAuthorId": "KUAAABLO",
    "eventType": "FolderAttachmentDeleted",
    "lastUpdatedDate": "2024-09-05T07:59:59Z"
}

FolderCustomFieldChanged

Fired when a custom field value is changed for folder or project

{
    "customFieldId": "IEAAABDUJUAAAABA",
    "oldValue": "1",
    "value": "2",
    "folderId": "IEAAABDUI4AB5FNJ",
    "webhookId": "IEAAABDUJAAAABBH",
    "eventAuthorId": "KUAAABLQ",
    "eventType": "FolderCustomFieldChanged",
    "lastUpdatedDate": "2024-09-05T08:01:24Z"
}

ProjectDatesChanged

Fired when the start or end dates of a project are changed

{
    "oldValue": {
        "type": "Backlog",
        "workOnWeekends": false
    },
    "dates": {
        "type": "Planned",
        "startDate": "2024-09-02T00:00:00",
        "dueDate": "2024-09-03T00:00:00",
        "workOnWeekends": false
    },
    "folderId": "IEAAABDWI4AB5FNP",
    "webhookId": "IEAAABDWJAAAABBJ",
    "eventAuthorId": "KUAAABLS",
    "eventType": "ProjectDatesChanged",
    "lastUpdatedDate": "2024-09-05T08:03:04Z"
}

ProjectOwnersAdded

Fired when any new owner is assigned to a project, including all Wrike users (and Collaborators) and users with pending invitations

{
    "addedOwners": [
        "KUAAABLU",
        "KUAAABLV"
    ],
    "folderId": "IEAAABDXI4AB5FNS",
    "webhookId": "IEAAABDXJAAAABBK",
    "eventAuthorId": "KUAAABLT",
    "eventType": "ProjectOwnersAdded",
    "lastUpdatedDate": "2024-09-05T08:11:42Z"
}

ProjectOwnersRemoved

Fired when an owner is unassigned from a project

{
    "removedOwners": [
        "KUAAABLU",
        "KUAAABLV"
    ],
    "folderId": "IEAAABDXI4AB5FNS",
    "webhookId": "IEAAABDXJAAAABBK",
    "eventAuthorId": "KUAAABLT",
    "eventType": "ProjectOwnersRemoved",
    "lastUpdatedDate": "2024-09-05T08:11:42Z"
}

ProjectStatusChanged

Fired when a project status changes

{
    "oldStatus": "In Progress",
    "status": "Completed",
    "oldCustomStatusId": "IEABPELHJMAMIUZO",
    "customStatusId": "IEABPELHJMAMIUZF",
    "taskId": "IEABPELHI4AQE2MM",
    "webhookId": "IEABPELHJAAABATM",
    "eventAuthorId": "KUGEUT27",
    "eventType": "ProjectStatusChanged",
    "lastUpdatedDate": "2019-06-17T11:42:28Z"
}

TaskApprovalStatusChanged

Fired when a task's approval status is changed

[
 {
  "approvalId": "IEADGRKWMEAD3QBO",
  "status": "Approved",
  "taskId": "IEAFAZ72KRD5STHF",
  "webhookId": "IEADGRKWJAAAY2DH",
  "eventAuthorId": "KUAG52VT",
  "eventType": "TaskApprovalStatusChanged",
  "lastUpdatedDate": "2021-03-03T14:21:04Z"
 }
]

TaskApprovalDecisionChanged

Fired when a user gives his decision on approval for task

[
 {
  "approvalId": "IEADGRKWMEAD3QBO",
  "decision": "Approved",
  "taskId": "IEAFAZ72KRDTW4GG",
  "webhookId": "IEADGRKWJAAAY2DH",
  "eventAuthorId": "KUAG52VT",
  "eventType": "TaskApprovalDecisionChanged",
  "lastUpdatedDate": "2021-03-03T14:21:04Z"
 }
]

TaskApprovalDecisionReset

Fired when a user's actions reset a previous decision for task. For example, if a task's files have been tejected and the approval tejected, when a user uploads a new version of a file the approval decision is reset, and this event is triggered.

{
    "approvalId" : "IEAAABDYMEAAAACK",
    "approverIds" : [ "KUAAABLW", "KUAAABLX" ],
    "taskId" : "IEAAABDYKQAB5FNZ",
    "webhookId" : "IEAAABDYJAAAABBL",
    "eventAuthorId" : "KUAAABLW",
    "eventType" : "TaskApprovalDecisionReset",
    "lastUpdatedDate" : "2024-09-05T08:15:33Z"
  }

FolderApprovalStatusChanged

Fired when a folder's or project's approval status is changed

{
    "approvalId": "IEAAABDZMEAAAACL",
    "status": "Cancelled",
    "folderId": "IEAAABDZI4AB5FOA",
    "webhookId": "IEAAABDZJAAAABBM",
    "eventAuthorId": "KUAAABL2",
    "eventType": "FolderApprovalStatusChanged",
    "lastUpdatedDate": "2024-09-05T08:16:55Z"
}

FolderApprovalDecisionChanged

Fired when a folder's or project's approval final decision is changed

{
    "approvalId": "IEAAABD2MEAAAACM",
    "decision": "Rejected",
    "folderId": "IEAAABD2I4AB5FOD",
    "webhookId": "IEAAABD2JAAAABBN",
    "eventAuthorId": "KUAAABL4",
    "eventType": "FolderApprovalDecisionChanged",
    "lastUpdatedDate": "2024-09-05T08:18:51Z"
}

FolderApprovalDecisionReset

Fired when a user's actions reset a previous decision for folder or project. For example, if a folder's files have been rejected and the approval rejected, when a user uploads a new version of an approval file the approval decision is reset, and this event is triggered.

{
    "approvalId": "IEAAABD3MEAAAACN",
    "approverIds": [
        "KUAAABL7",
        "KUAAABMA"
    ],
    "folderId": "IEAAABD3I4AB5FOI",
    "webhookId": "IEAAABD3JAAAABBO",
    "eventAuthorId": "KUAAABL7",
    "eventType": "FolderApprovalDecisionReset",
    "lastUpdatedDate": "2024-09-05T08:20:13Z"
}

WorkItemTypeChanged

Fired when a user changes the type of a work item, e.g., when an ordinary Task is converted to a particular Custom Item Type.

{
    "workItemId": "IEAAABD4KQAB5FOR",
    "oldWorkItemTypeId": "IEAAABD4PIAAAABP",
    "newWorkItemTypeId": "IEAAABD4PIAAAABQ",
    "newWorkItemTypeTitle": "new template title",
    "webhookId": "IEAAABD4JAAAABBP",
    "eventAuthorId": "KUAAABMD",
    "eventType": "WorkItemTypeChanged",
    "lastUpdatedDate": "2024-09-05T08:23:48Z"
}

ImportFromFileCompleted

Fired when import from Excel or Microsoft Project file is completed

{
    "parentTaskGroupId": "IEAAABD5I4AB5FOU",
    "attachmentId": "IEAAABD5IYAB5BF3",
    "webhookId": "IEAAABD5JAAAABBQ",
    "eventAuthorId": "KUAAABME",
    "eventType": "ImportFromFileCompleted",
    "lastUpdatedDate": "2024-09-05T08:26:02Z"
}

The following events are not yet supported (and do not trigger notifications):

  • Changes made with mass actions, including importing tasks

Webhook URL Requirements

Current requirements for hookUrl are following:

  • Web protocol must be present in the URL and must be either http or https, other protocols are not supported (and will not be)

  • Address must be global, not an intranet address (https://en.wikipedia.org/wiki/Private_network)

  • Port (if specified) must be either 80 or 443

If an incorrect port is used, you will receive a generic error message as follows:

{
    "errorDescription":"Parameter 'hookUrl' value is invalid",
    "error":"invalid_parameter"
}

Examples of Valid hookUrls:

hookUrl=https://[Global_IP_address]:80/receiver
hookUrl=https://[Global_IP_address]:433/receiver

Verifying the Accessibility of the Hook URL

To validate the accessibility of a hook URL, send a POST request to the URL.

POST https://webhook.site/7fbe2965-3d60-4d11-ac6d-f5c792ac1723

Successful connectivity is indicated by one of the following HTTP status codes in the response:

  • 200 OK

  • 201 Created

  • 202 Accepted

  • 204 No Content

Webhooks delivery

To ensure proper webhooks delivery from Wrike, whitelist following IP subnets:

  • For US DC: 160.19.162.0/23, 34.73.3.211/32

  • For US2 DC: 35.196.104.95/32, 34.72.158.28/32

  • For EU DC: 185.157.64.0/22, 146.148.2.222/32

Secure Webhooks

Wrike optionally supports signing event payloads with a secret, pre-shared between client and Wrike. This provides a mechanism to check authenticity of the request and make sure it is indeed coming from Wrike and goes to the client who registered it.

The general flow looks like follows:

  1. In order to register a secure webhook, send secret parameter: 
    https://www.wrike.com/api/v4/webhooks?hookUrl=<url>&secret=<some_secret>.

  2. Wrike sends request to hookUrl with header X-Hook-Secret, which contains random alphanumeric string. This request will also have the following body - {"requestType": "WebHook secret verification"}.

  3. Client should calculate hmacSha256(key: secret, value: received X-Hook-Secret value) and add calculated value to the response X-Hook-Secret header.

  4. All events from webhook will contain X-Hook-Secret header with value hmacSha256(key: secret, value: request body) so client can check authenticity of the events.

Example of Usage

Use Case Example

Let’s assume a task is related to the development process, and a “Completed” status means that all code was committed/pushed to the source repository. This change could trigger a CI build via some CI REST endpoint.

Step 1

Create an account-wide webhook.

Get your accountId using the following CURL command:

curl -g -X GET -H 'Authorization: bearer <access_token>' 'https://www.wrike.com/api/v4/account'

The response contains a list of your accounts:

{
    "kind": "accounts",
    "data": [
        {
        "id": "IEAADQQL",
        "name": "My Personal Account",
        "dateFormat": "MM/dd/yyyy",
        "firstDayOfWeek": "Mon",
        "workDays": [
            "Sun",
            "Mon",
            "Tue",
            "Wed",
            "Thu",
            "Fri",
            "Sat"
        ],
        "rootFolderId": "IEAAAOVII7777777",
        "recycleBinId": "IEAAAOVII7777776",
        "createdDate": "2013-12-30T12:17:24Z",
        "joinedDate": "2015-08-04T13:56:13Z"
        }
    ]
}

You will need “id” field for future requests (“IEAADQQL” in the example above).

Step 2

Execute the following CURL command to create a new account-wide webhook and subscribe your endpoint (https://yourwebhookserver.com/event-handler) to notifications.

Get your accountId using the following CURL command:

curl -g -X POST -H 'Authorization: bearer <access_token>' -d 'hookUrl=https://yourwebhookserver.com/event-handler' 'https://www.wrike.com/api/v4/webhooks'

You’ll see the following response:

{
    "kind": "webhooks",
    "data": [
        {
        "id": "IEAADQQLJAAAAULN",
        "accountId": "IEAADQQL",
        "hookUrl": "https://yourwebhookserver.com/event-handler",
        "status": "Active"
        }
    ]
}

Step 3

Next, change a task in the account (for example, change a task’s status from “Active” to “Completed”). You’ll receive the following payload on your endpoint:

{
    "oldStatus": "Active",
    "status": "Completed",
    "webhookId": "IEAADQQLJAAAAULN",
    "eventAuthorId": "KUAALDRX",
    "eventType": "TaskStatusChanged",
    "lastUpdatedDate": "2016-11-22T11:09:58Z"
}

Suspended Webhooks

If a webhook is suspended, Wrike sends an email notification to the webhook author. If your endpoint is shut down or not accessible via the internet, we automatically suspend the webhook based on the response status. In this case, the following request using the given webhook ID will return the “Suspended” state for the webhook:

curl -g -X GET -H 'Authorization: bearer <access_token>' 'https://www.wrike.com/api/v4/webhooks/IEAADQQLJAAAAULN'

Response reflecting “Suspended” state:

{
    "kind": "webhooks",
    "data": [
        {
        "id": "IEAADQQLJAAAAULN",
        "accountId": "IEAADQQL",
        "hookUrl": "https://yourwebhookserver.com/event-handler",
        "status": "Suspended"
        }
    ]
}

Retries for Webhooks

For retryable HTTP statuses, we attempt delivering up to 3 times. If all attempts fail, the webhook is suspended. However, for non-retryable HTTP statuses - all 4xx status codes, except for 408 and 429 - the webhook gets suspended immediately with no retries.

Additionally, if endpoints continue to fail and retries prove ineffective, the system will temporarily suspend all retries to prevent unnecessary delays.

Restart Webhooks

Restart the webhook using the following PUT request:

curl -g -X PUT -H 'Authorization: bearer <access_token>' 'https://www.wrike.com/api/v4/webhooks/IEAADQQLJAAAAULN'

Response:

{
    "kind": "webhooks",
    "data": [
        {
        "id": "IEAADQQLJAAAAULN",
        "accountId": "IEAADQQL",
        "hookUrl": "https://yourwebhookserver.com/event-handler",
        "status": "Active"
        }
    ]
}

You can get a list of your webhooks (and their states) at any time:

curl -g -X GET -H 'Authorization: bearer <access_token>' 'https://www.wrike.com/api/v4/webhooks'

Response will contain JSON with all of webhooks created by you. Similar to:

{
    "kind": "webhooks",
    "data": [
        {
        "id": "IEAADQQLJAAAAULN",
        "accountId": "IEAADQQL",
        "hookUrl": "https://yourwebhookserver.com/event-handler",
        "status": "Active"
        }
    ]
}

Handling duplicate deliveries

We cannot guarantee exactly-once delivery of events via webhooks. It is possible that due to network issues, the same payload may be re-delivered to your handler. You can prevent the processing of such duplicate deliveries by using an Idempotency-Key header in the request. The Idempotency-Key contains a unique identifier for each event, allowing you to determine if the event has already been processed.