API Reference

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