API Reference

Company - New Hires

Notifies you when new employees are detected joining your tracked companies. This radar type helps you monitor team growth and talent acquisition trends.

Content Structure

The content object for new hires contains:

FieldTypeRequiredNullableDescription
full_namestringYesNoFull name of the new hire
first_namestringYesNoFirst name of the new hire
last_namestringYesNoLast name of the new hire
linkedin_urlstringYesNoURL to the person's public LinkedIn profile
titlestringYesNoJob title of the new hire
start_datestringYesNoBest estimated start date (YYYY-MM-DD)
countrystringYesYesCountry of employment

Example

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

{
  "event_id": "41991828-ed31-4bd9-98d2-44b2763f9f35",
  "event_type": "radar_finding",
  "record_id": "b77af154-c369-4446-b70a-f328880c3a48",
  "discovered_at": "2024-03-20T12:30:00Z",
  "data": {
    "radar_id": "c70813b3-7e87-4ca7-90fd-8c64574d911b",
    "radar_type": "new_hires",
    "domain": "domain.com",
    "next_charge_at": "2024-04-20T12:30: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/joedoe/",
    "title": "Senior Product Designer",
    "start_date": "2024-03-15",
    "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.