API Reference

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"
  }
}