---
title: Job Tracking - Session Update Webhooks
description: "The first key should only be assigned when a webhook is received with all the following parameters: Type of webhook is WORK SESSION update. The payload has: "action": "work_session.update" Status of s"
---

[Skip to content](https://cx.sera4.com/job-tracking-session-webhooks#main-content)

English

Show submenu for translations

![Sera4 Logo\_white-2](https://cx.sera4.com/hubfs/Sera4%20Logo_white-2.svg)

- [Default HubSpot Blog](https://sera4-3787649.hs-sites.com/blog)

Open main navigation

Close main navigation

- [Default HubSpot Blog](https://sera4-3787649.hs-sites.com/blog)
- English
  
  Show submenu for translations
- [Go to sera4.com](https://sera4.com/)

[Go to sera4.com](https://sera4.com/)

 Hello. How can we help you?

- There are no suggestions because the search field is empty.

1. [Help Center](https://cx.sera4.com/?hsLang=en)
2. [Onboarding](https://cx.sera4.com/onboarding?hsLang=en)
3. [Job Tracking](https://cx.sera4.com/onboarding?hsLang=en#job-tracking)

# Job Tracking - Session Update Webhooks

### Guideline to Assign First Key during a session

The first key should only be assigned when a webhook is received with all the following parameters:

1. Type of webhook is WORK SESSION update. The payload has:
   
     1. `"action": "work_session.update"`
2. Status of session is STARTED. The payload has:
   
     1. `"status": 0` which means STARTED
3. Webhook **DOES NOT** have **keys** within `options` field of payload.

 

Once a key is assigned, careful consideration must be taken before assigning more keys to avoid duplicate keys. The flowchart below provides a guideline to avoid key duplication, where the third-party system is expected to validate if the user requires a different key before assigning more.

 

![](https://cx.sera4.com/hs-fs/hubfs/Blank%20diagram-4-png.png?width=906&height=1577&name=Blank%20diagram-4-png.png)

 

### Example of "work\_session.update" Webhook without Keys in options field

```
{  "tenant": {    "id": "8231b3fa-78f3-4ea6-b423-8f3877fe4a6c",    "name": "sesame"  },  "url": "/v3/public/work_sessions/ce88a8e2-c69b-4a6e-b047-a47ca9001842",  "event": "evt_b0d837bb-739f-43ab-98c4-3973b91efb27",  "type": "event",  "api_version": "2021-10-26",  "live_mode": true,  "data": [    {      "action": "work_session.update",      "object": {        "id": "ce88a8e2-c69b-4a6e-b047-a47ca9001842",        "lock": {          "id": 23585,          "name": "Lock-5C21",          "site": {            "id": 83,            "name": "Joel"          },          "deleted": false,          "deactivated": false,          "description": "Lock-5C21",          "lock_type_id": 1,          "hardware_type": "AP3"        },        "site": {          "id": 83,          "name": "Joel"        },        "user": {          "name": "Joel Matsu",          "email": "joel.matsu@sera4.com",          "username": "joel572",          "membership_id": "f20d0df4-3b74-4cf8-9a92-0a44631e3280"        },        "wstl": 480,        "status": 0,        "options": {          "flow": "confirmation_required",          "tasks": [            "Installation",            "Maintenance"          ],          "chosen_tasks": [            "Maintenance"          ],          "ticket_number": "T-123"        },        "comments": "",        "duration": "",        "wstl_as_time": "08:00:00",        "membership_id": "f20d0df4-3b74-4cf8-9a92-0a44631e3280",        "time_exceeded": false,        "locksmith_uuid": "a6e0427b2e5d480391ce1d6b1e6cc883",        "close_confirmed": false,        "started_at_time": "2025-09-10T17:52:24.470Z",        "started_at_location": {          "lat": "-23.86608126363599",          "lng": "-49.80470585224187"        },        "photo_notes_confirmed": false      },      "object_meta": {        "changes": [          "status",          "options"        ]      },      "id": 67225,      "attempt": 1,      "created_at": "2025-09-10T17:55:19.916Z"    }  ]}
```

### Example of "work\_session.update" Webhook with Keys in options field .

This webhook is received after one ore more keys have been assigned. 

```
{  "tenant": {    "id": "8231b3fa-78f3-4ea6-b423-8f3877fe4a6c",    "name": "sesame"  },  "url": "/",  "event": "evt_ag-2891d6d5-94ef-4be9-a7ec-f788c2d39bb5",  "type": "event",  "api_version": "2021-10-26",  "live_mode": true,  "data": [    {      "action": "work_session.update",      "object": {        "id": "ce88a8e2-c69b-4a6e-b047-a47ca9001842",        "lock": {          "id": 23585,          "name": "Lock-5C21",          "site": {            "id": 83,            "name": "Joel"          },          "deleted": false,          "deactivated": false,          "description": "Lock-5C21",          "lock_type_id": 1,          "hardware_type": "AP3"        },        "site": {          "id": 83,          "name": "Joel"        },        "user": {          "name": "Joel Matsu",          "email": "joel.matsu@sera4.com",          "username": "joel572",          "membership_id": "f20d0df4-3b74-4cf8-9a92-0a44631e3280"        },        "wstl": 480,        "status": 0,        "options": {          "flow": "confirmation_required",          "keys": [            {              "id": 12526,              "set_by": 10            }          ],          "tasks": [            "Installation",            "Maintenance"          ],          "chosen_tasks": [            "Maintenance"          ],          "ticket_number": "T-123"        },        "comments": "",        "duration": "",        "wstl_as_time": "08:00:00",        "membership_id": "f20d0df4-3b74-4cf8-9a92-0a44631e3280",        "time_exceeded": false,        "locksmith_uuid": "a6e0427b2e5d480391ce1d6b1e6cc883",        "close_confirmed": false,        "started_at_time": "2025-09-10T17:52:24.470Z",        "started_at_location": {          "lat": "-23.86608126363599",          "lng": "-49.80470585224187"        },        "photo_notes_confirmed": false      },      "object_meta": {        "changes": [          "options"        ]      },      "id": 67226,      "attempt": 1,      "created_at": "2025-09-10T17:57:57.991Z"    }  ]}
```

 

- [Onboarding](https://cx.sera4.com/onboarding?hsLang=en#main-content)

    - [Intro to Teleporte](https://cx.sera4.com/onboarding?hsLang=en#intro-to-teleporte)
    - [Intro for Users](https://cx.sera4.com/onboarding?hsLang=en#intro-for-users)
    - [Intro for Administrators](https://cx.sera4.com/onboarding?hsLang=en#intro-for-administrators)
    - [Mobile Application](https://cx.sera4.com/onboarding?hsLang=en#mobile-application)
    - [Web Interface](https://cx.sera4.com/onboarding?hsLang=en#web-interface)
    - [AP3 Padlock](https://cx.sera4.com/onboarding?hsLang=en#ap3-padlock)
    - [Controllers](https://cx.sera4.com/onboarding?hsLang=en#controllers)
    - [KSC1](https://cx.sera4.com/onboarding?hsLang=en#ksc1)
    - [Job Tracking](https://cx.sera4.com/onboarding?hsLang=en#job-tracking)
- [FAQ](https://cx.sera4.com/faq?hsLang=en#main-content)

    - [Mobile App](https://cx.sera4.com/faq?hsLang=en#mobile-app)
    - [Web Interface](https://cx.sera4.com/faq?hsLang=en#web-interface)
    - [AP3 Padlock](https://cx.sera4.com/faq?hsLang=en#ap3-padlock)
    - [Security](https://cx.sera4.com/faq?hsLang=en#security)
- [Troubleshooting](https://cx.sera4.com/troubleshooting?hsLang=en#main-content)

    - [General Troubleshooting](https://cx.sera4.com/troubleshooting?hsLang=en#general-troubleshooting)
    - [AP3 Padlock Troubleshooting](https://cx.sera4.com/troubleshooting?hsLang=en#ap3-padlock-troubleshooting)
    - [Web Interface Troubleshooting](https://cx.sera4.com/troubleshooting?hsLang=en#web-interface-troubleshooting)
- [Resources](https://cx.sera4.com/resources?hsLang=en#main-content)

    - [Documents](https://cx.sera4.com/resources?hsLang=en#documents)
    - [Installation Guides](https://cx.sera4.com/resources?hsLang=en#installation-guides)
    - [Manuals](https://cx.sera4.com/resources?hsLang=en#manuals)
    - [Product Portal](https://cx.sera4.com/resources?hsLang=en#product-portal)

- [Default HubSpot Blog](https://sera4-3787649.hs-sites.com/blog)

[![Sera4 Logo\_white-2](https://cx.sera4.com/hubfs/Sera4%20Logo_white-2.svg "Sera4 Logo_white-2")](http://sera4.com)

For all additional inquiries, please message us at cx@sera4.com

Copyright © 2025, Sera4