Company New Hires - TAMradar API Docs

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:

Field	Type	Required	Nullable	Description
full_name	string	Yes	No	Full name of the new hire
first_name	string	Yes	No	First name of the new hire
last_name	string	Yes	No	Last name of the new hire
profile_url	string	Yes	No	URL to the person’s professional profile
title	string	Yes	No	Job title of the new hire
start_date	string	Yes	No	Best estimated start date (YYYY-MM-DD)
country	string	Yes	Yes	Country of employment
departments	string[]	Yes	No	Department categories (1–3 values). Values: `Accounting`, `Administrative`, `Business Development`, `Consulting`, `Customer Success`, `Design`, `Education`, `Engineering`, `Finance`, `Human Resources`, `Information Technology`, `Leadership`, `Legal`, `Manufacturing`, `Marketing`, `Media and Communication`, `Operations`, `Product Management`, `Project Management`, `Purchasing`, `Quality Assurance`, `Real Estate`, `Research`, `Sales`, `Support`, `Other`
seniority	string	Yes	No	Seniority level. One of: `Owner`, `CXO`, `Vice President`, `Director`, `Manager`, `Senior`, `Entry`, `Training`, `Partner`, `Other`

Example

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

{
  "update_id": "41991828-ed31-4bd9-98d2-44b2763f9f35",
  "update_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": "company_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",
    "profile_url": "https://www.linkedin.com/in/joedoe/",
    "title": "Senior Product Designer",
    "start_date": "2024-03-15",
    "country": "United States",
    "departments": ["Design"],
    "seniority": "Senior"
  }
}