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	Yes	Details of the new role. Fields contain null values for ‘departure’ type changes.
previous_role	object	Yes	Details of the previous role at the tracked domain. Fields contain null values for ‘additional_role’ type changes and when no previous role exists.

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

Change Type Examples

Change Type	new_role	previous_role	Use Case
`departure`	All fields are null	Populated (last role at tracked company)	Contact left your tracked company
`promotion`	Populated (new role at same company)	Populated (previous role at same company)	Title/role change within tracked company
`additional_role`	Populated (role at different company)	All fields are null	Added advisor/board role while staying
`new_company_role`	Populated (role at different company)	Populated (last role at tracked company)	Left tracked company for new position

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

Both role objects are always present with consistent structure. Individual fields contain null values when information is not available or not applicable.

Example

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

{
  "update_id": "15c83d05-f81a-4b6c-a64d-e594b13d11a7",
  "update_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"
    },
    "profile_url": "https://www.linkedin.com/in/jane-smith-marketing/",
    "email": "jane.smith@acme.com",
    "full_name": "Jane Smith"
  },
  "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. Previous Role Context: The previous_role object contains the role at the company you originally tracked, not necessarily the most recent role the person held. For example, if you’re tracking someone at Microsoft and they move to Meta, then later move to Google, the previous_role will show their Microsoft role (your tracked company), not their Meta role. Tracking Continuity: If you do not want to track contacts at new companies that TAMradar identifies, you should deactivate the radar. For example, if you’re tracking someone at Microsoft and they move to Meta, TAMradar will automatically start tracking their Meta role. Deactivate the radar if you only want to monitor the original company.

Introduction / Overview

Getting Started

Core Guides

Agentic Setup

API Reference

Bulk

Webhooks

Content Structure

Change Types

Change Type Examples

Role Object Structure

Example

Important Notes

​Content Structure

​Change Types

​Change Type Examples

​Role Object Structure

​Example

​Important Notes

Content Structure

Change Types

Change Type Examples

Role Object Structure

Example

Important Notes