Contact Job Changes

Notifies you when tracked individuals experience career changes such as job departures, promotions, additional roles, or moves to new companies. This radar type helps you monitor contact movements and relationship changes.

Content Structure

The content object contains the job change information:

Field	Type	Required	Description
change_type	string	Yes	Type of change: "departure", "promotion", "additional_role", "new_company_role"
profile_url	string	Yes	LinkedIn profile URL of the contact for identification
new_role	object	Conditional	Details of the new role (omitted for "departure" type)
previous_role	object	Conditional	Details of the previous role (omitted when not relevant)

Change Types

Type	Description
`departure`	Contact left the tracked company; no new role detected yet
`promotion`	Contact received a promotion or role change within the same company
`additional_role`	Contact gained an additional role (advisor, board member) while staying at tracked company
`new_company_role`	Contact left the tracked company and joined another company

Role Object Structure

Both new_role and previous_role objects contain:

Field	Type	Description
title	string	Job title or position
company_name	string	Company name
company_domain	string	Company domain
start_date	string	Role start date (YYYY-MM-DD)
end_date	string	Role end date (YYYY-MM-DD), null if current

Example

This example includes base webhook fields along with contact-job-change-specific content:

{
  "event_id": "15c83d05-f81a-4b6c-a64d-e594b13d11a7",
  "event_type": "radar_finding",
  "record_id": "b8b9c213-4ed2-4b7f-8e46-7a1398d4e2fa",
  "discovered_at": "2025-07-02T19:03:43Z",
  "data": {
    "radar_id": "4e8f0a7b-6c52-4a4b-b15c-3a7f9b5c1d9d",
    "radar_type": "contact_job_changes",
    "domain": "acme.com",
    "next_charge_at": "2025-08-02T19:03:43Z",
    "custom_fields": {
      "contact_tier": "enterprise",
      "account_id": "0011U00000ABCDEF"
    }
  },
  "content": {
    "change_type": "new_company_role",
    "profile_url": "https://www.linkedin.com/in/jane-smith-marketing/",
    "new_role": {
      "title": "Director of Marketing Operations",
      "company_name": "ExampleCorp",
      "company_domain": "example.com",
      "start_date": "2024-12-01",
      "end_date": null
    },
    "previous_role": {
      "title": "Senior Marketing Manager",
      "company_name": "ACME Inc",
      "company_domain": "acme.com",
      "start_date": "2021-07-01",
      "end_date": "2024-12-01"
    }
  }
}

Important Notes

Contact Identification: Contacts are identified during radar creation using email, LinkedIn profile URL, or full name
Multiple Contacts: You can track multiple individuals at the same company with separate radars
Privacy: Profile URLs are included for contact identification; other personal identifiers remain excluded
Tracking Period: Changes are detected based on publicly available professional information