Using Webhooks to get task completion notifications

Overview:

  • Create endpoint to receive HTTP calls from Record360
  • Add url for endpoint to company task completion url example «-EXAMPLE Example Webhook URL: https://webhook.site/4b8b4eb5-5312-41c4-a55b-27f558fdfe6b- this is a generated webhook endpoint Steps to get notifications based on task updates (completion) using webhook endpoint:
  1. Create webhook endpoint to receive HTTP calls from our server
  2. Add in this webhook url to the Task Completion Webhook URL field on your company- contact support to do so
  3. Create a task and complete it
  4. You should receive an HTTP POST response- examples of serialized created task and response to completion below

Task Created on dashboard:

{
    "data": {
        "task": {
            "id": "3824",
            "name": "Task Example",
            "description": null,
            "createdAt": "2022-10-27T17:51:03Z",
            "assignee": {
                "id": "2386",
                "name": "Lily Jones"
            },
            "requester": {
                "id": "2556",
                "name": "John Smith"
            },
            "unit": null,
            "status": "idle",
            "highPriority": true,
            "draft": null,
            "dueBy": "2022-10-27T17:50:41Z",
            "type": "task",
            "company": {
                "id": "64"
            },
            "location": {
                "id": "1000000251",
                "name": "Alex's Test Location",
                "company": {
                    "id": "64",
                    "name": "New Test"
                },
                "workflow": {
                    "externalIdLock": "open",
                    "keyboard": null,
                    "capitalization": null,
                    "noSpacesAllowed": null
                }
            },
            "comments": {
                "edges": []
            },
            "activities": {
                "edges": [
                    {
                        "node": {
                            "id": "8681",
                            "event": "Created Task",
                            "createdAt": "2022-10-27T17:51:03Z",
                            "user": {
                                "id": "2556",
                                "email": "[email protected]"
                            }
                        }
                    }
                ]
            },
            "markPageAsViewed": {
                "errors": []
            }
        }
    }
}

After a task is completed in your company on dashboard:

{
  "id": "3824",
  "due_by": "2022-10-27T17:50:41.000Z",
  "name": "Task Example",
  "status": "completed",
  "created_at": "2022-10-27T17:51:03.795Z",
  "updated_at": "2022-10-27T17:52:21.849Z",
  "high_priority": true,
  "location": {
    "id": "1000000251",
    "name": "Alex's Test Location"
  },
  "assignee": {
    "id": "2386",
    "email": "[email protected]",
    "name": "Lily Jones"
  },
  "requester": {
    "id": "2556",
    "email": "[email protected]",
    "name": "John Smith"
  },
  "activities": [
    {
      "event": "Completed Task",
      "user": {
        "id": "2556",
        "email": "[email protected]",
        "name": "John Smith"
      },
      "created_at": "2022-10-27T17:52:21.872Z"
    },
    {
      "event": "Created Task",
      "user": {
        "id": "2556",
        "email": "[email protected]",
        "name": "John Smith"
      },
      "created_at": "2022-10-27T17:51:03.799Z"
    }
  ]
}