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	Nullable	Description
change_type	string	No	Type of change: “departure”, “promotion”, “additional_role”, “new_company_role”
profile_url	string	No	LinkedIn profile URL of the contact for identification
new_role	object	No	Details of the new role. Fields contain null values for ‘departure’ type changes.
previous_role	object	No	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	Nullable	Description
title	string	Yes	Job title or position
company_name	string	Yes	Company name
company_domain	string	Yes	Company domain
start_date	string	Yes	Role start date (YYYY-MM-DD)
end_date	string	Yes	Role end date (YYYY-MM-DD), null if current role

Both role objects are always present in the payload with a consistent structure. Structural nulls: When a change type leaves an entire object empty (e.g. departure → all new_role fields null, additional_role → all previous_role fields null), this is indicated in the Change Type Examples table above. Data nulls: Within a populated object, end_date is null when the role is current. company_domain may be null if the company has no public domain. Other fields are populated whenever the data is available from the source.

Examples

These examples include base webhook fields along with contact-job-change-specific content. Select a change type to see its payload shape.

{
  "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": "examplecorp.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"
    }
  }
}

{
  "update_id": "a3c72f01-88d4-4e3b-b921-7d3f2a1c9e45",
  "update_type": "radar_finding",
  "record_id": "d4e5f678-1234-4abc-9def-0a1b2c3d4e5f",
  "discovered_at": "2025-07-15T10:22:00Z",
  "data": {
    "radar_id": "4e8f0a7b-6c52-4a4b-b15c-3a7f9b5c1d9d",
    "radar_type": "contact_job_changes",
    "domain": "acme.com",
    "next_charge_at": "2025-08-15T10:22:00Z",
    "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": "departure",
    "profile_url": "https://www.linkedin.com/in/jane-smith-marketing/",
    "new_role": {
      "title": null,
      "company_name": null,
      "company_domain": null,
      "start_date": null,
      "end_date": null
    },
    "previous_role": {
      "title": "Senior Marketing Manager",
      "company_name": "ACME Inc",
      "company_domain": "acme.com",
      "start_date": "2021-07-01",
      "end_date": "2025-07-01"
    }
  }
}

{
  "update_id": "f9e8d7c6-b5a4-4321-8765-1a2b3c4d5e6f",
  "update_type": "radar_finding",
  "record_id": "c1d2e3f4-5678-4abc-bdef-9a8b7c6d5e4f",
  "discovered_at": "2025-06-01T08:15:00Z",
  "data": {
    "radar_id": "4e8f0a7b-6c52-4a4b-b15c-3a7f9b5c1d9d",
    "radar_type": "contact_job_changes",
    "domain": "acme.com",
    "next_charge_at": "2025-07-01T08:15:00Z",
    "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": "promotion",
    "profile_url": "https://www.linkedin.com/in/jane-smith-marketing/",
    "new_role": {
      "title": "Director of Marketing",
      "company_name": "ACME Inc",
      "company_domain": "acme.com",
      "start_date": "2025-06-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": "2025-06-01"
    }
  }
}

{
  "update_id": "b2c3d4e5-f6a7-4890-abcd-ef1234567890",
  "update_type": "radar_finding",
  "record_id": "e5f6a7b8-9012-4cde-f345-6789abcdef01",
  "discovered_at": "2025-05-10T14:30:00Z",
  "data": {
    "radar_id": "4e8f0a7b-6c52-4a4b-b15c-3a7f9b5c1d9d",
    "radar_type": "contact_job_changes",
    "domain": "acme.com",
    "next_charge_at": "2025-06-10T14:30:00Z",
    "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": "additional_role",
    "profile_url": "https://www.linkedin.com/in/jane-smith-marketing/",
    "new_role": {
      "title": "Advisor",
      "company_name": "TechVentures Fund",
      "company_domain": "techventuresfund.com",
      "start_date": "2025-05-01",
      "end_date": null
    },
    "previous_role": {
      "title": null,
      "company_name": null,
      "company_domain": null,
      "start_date": null,
      "end_date": null
    }
  }
}

Important Notes

Contact Identification: Radar creation accepts an individual email, a LinkedIn person profile URL (linkedin.com/in/...), or a full name. Role-based/shared emails and company, school, or legacy /pub/ LinkedIn URLs are rejected. Within the same company and radar type, duplicate matching uses email or the normalized LinkedIn profile URL; full name alone is not a duplicate key. Multiple Contacts: You can track multiple individuals at the same company with separate radars. Contact Identifiers in Payload: The data object echoes back the identifiers you supplied at radar creation (profile_url, email, full_name). Only the fields you originally provided are included — if you created the radar with a LinkedIn URL only, email and full_name will be absent from the payload. 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

Examples

Important Notes

​Content Structure

​Change Types

​Change Type Examples

​Role Object Structure

​Examples

​Important Notes

Content Structure

Change Types

Change Type Examples

Role Object Structure

Examples

Important Notes