> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tamradar.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Company Promotions

> Company Promotions documentation for TAMradar API.

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:

| Field           | Type   | Required | Nullable | Description                                   |
| --------------- | ------ | -------- | -------- | --------------------------------------------- |
| full\_name      | string | Yes      | No       | Full name of the promoted person              |
| first\_name     | string | Yes      | No       | First name of the promoted person             |
| last\_name      | string | Yes      | No       | Last name of the promoted person              |
| profile\_url    | string | Yes      | No       | URL to the person's professional profile      |
| previous\_title | string | Yes      | No       | Job title before the promotion                |
| current\_title  | string | Yes      | No       | New job title after the promotion             |
| promotion\_date | string | Yes      | No       | Best estimated date of promotion (YYYY-MM-DD) |
| country         | string | Yes      | Yes      | Country of employment                         |

### Example

This example includes [base webhook fields](/webhooks/overview) along with promotion-specific content:

```json theme={null}
{
  "update_id": "41991828-ed31-4bd9-98d2-44b2763f9f35",
  "update_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": "company_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",
    "profile_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"
  }
}
```