---
title: "Job Updated Webhook"
method: POST
path: "job_updated"
---

# Job Updated Webhook

`POST job_updated` (webhook)

Triggered when any job, primary contact, job details are modified.

**Payload includes:**
* Complete current job state snapshot
* Updated contact and location details
* Work type and categorization changes
* Direct API links to job and related resources

Provides full system-of-record state for external synchronization.

## Payload

- JobUpdatedEvent
  - `eventDateTime` string, date-time
  - `eventId` string, uuid
  - `subscriptionId` string, uuid
  - `topicName` string
  - `event` object
    - `job` object
      - `id` string, uuid
      - `_link` string, uri
      - `contacts` JobContact[]
        - `id` string, uuid
        - `_link` string, uri
        - `contact` Contact
          - `id` string, uuid
          - `_link` string, uri
          - `companyName` string: The company name of given contact.
          - `crossReference` string: The cross reference of given contact.
          - `firstName` string: The first name of given contact.
          - `lastName` string: The last name of given contact.
          - `salutation` string: The salutation of given contact.
        - `isPrimary` boolean: Indicates if the contact is the primary contact related to a given Lead/Job.
      - `currentMilestone` 'Lead' | 'Prospect' | 'Approved' | 'Completed' | 'Invoiced' | 'Closed' | 'Cancelled': Is the current milestones of the job updated
      - `jobCategory` JobCategory
        - `id` integer
        - `name` string
      - `jobName` string: The name of the job updated
      - `jobNumber` string: The number of the job updated
      - `jobPriority` 'Normal' | 'High' | 'Urgent': Priority of the job. can be Normal, High or Urgent
      - `leadSource` LeadSource
        - `id` string, uuid
        - `_link` string, uri: The unique URI of the lead source.
        - `name` string
      - `locationAddress` Address
        - `city` string: Municipality name for the physical address
        - `country` Country
          - `id` integer: The id for the Country.
          - `_link` string: The URI of the Country.
          - `abbreviation` string: The 2 character abbreviation for the Country.
        - `state` State
          - `id` number: The id for the state.
          - `_link` string, uri: The URI of the State.
          - `abbreviation` string: The 2 character abbreviation for the State.
        - `street1` string: Primary street address line
        - `street2` string: Secondary street address line
        - `zipCode` string: Postal code for the address
      - `workType` WorkType
        - `id` integer
        - `name` string
        - `systemDefault` boolean

## Acknowledgement `204`

The webhook was received successfully.

## Other responses

- `400`: Bad Request - The server cannot process the request due to a client error. Common causes: - Invalid request format - Missing required fields - Validation errors in the request data
- `401`: Unauthorized - Authentication is required or has failed. Common causes: - Missing API key - Invalid API key - Expired or deactivated API key
- `404`: Not Found - The requested resource does not exist. Common causes: - Invalid subscription ID - Subscription has been deleted - URL path contains typos or incorrect values

---

[API](https://skmtc.dev/acculynx/apis/webhooks-api.md) - [All operations](https://skmtc.dev/acculynx/apis/webhooks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/acculynx/apis/webhooks-api/revisions/8bc7679859d8?raw)
