API Reference

Company - Promotions

Notifies you when employees are promoted at your tracked companies. This radar type helps you monitor career progression and organizational changes.

Content Structure

The content object for promotions contains:

FieldTypeRequiredNullableDescription
full_namestringYesNoFull name of the promoted person
first_namestringYesNoFirst name of the promoted person
last_namestringYesNoLast name of the promoted person
linkedin_urlstringYesNoURL to the person's LinkedIn profile
previous_titlestringYesNoJob title before the promotion
current_titlestringYesNoNew job title after the promotion
promotion_datestringYesNoBest estimated date of promotion (YYYY-MM-DD)
countrystringYesYesCountry of employment

Example

This example includes base webhook fields along with promotion-specific content:

{
  "event_id": "41991828-ed31-4bd9-98d2-44b2763f9f35",
  "event_type": "radar_finding",
  "record_id": "b77af154-c369-4446-b70a-f328880c3a48",
  "discovered_at": "2024-03-17T08:30:00Z",
  "data": {
    "radar_id": "c70813b3-7e87-4ca7-90fd-8c64574d911b",
    "radar_type": "promotions",
    "domain": "domain.com",
    "next_charge_at": "2024-04-20T15:45:00Z",
    "custom_fields": {
      "priority": "high",
      "account_id": "0011U00000TFV7MQAX"
    }
  },
  "content": {
    "full_name": "Joe Doe",
    "first_name": "Joe",
    "last_name": "Doe",
    "linkedin_url": "https://www.linkedin.com/in/joe-doe-755717101/",
    "previous_title": "Global Prospecting Specialist",
    "current_title": "Analyst, Global Service Center",
    "promotion_date": "2024-03-01",
    "country": "United States"
  }
}

Important Note:

For this radar type, TAMradar returns matching contacts as quickly as possible. The initial batch may include contacts from up to three months of historical data, though coverage for past months is not optimized. After the first day, you'll receive updates containing only contacts with role start dates from the current month.