---
title: "Add a headcount row to the forecast"
method: POST
path: "/companies/{companyId}/forecast/{forecastId}/headcount"
tags: ["Forecast"]
---

# Add a headcount row to the forecast

`POST /companies/{companyId}/forecast/{forecastId}/headcount`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/companies/{companyId}/forecast/{forecastId}/headcount`
- Auth: HTTP bearer

## Request body

- CreateForecastHeadcountInput
  - `role` string, required
  - `employmentType` 'w2' | 'contractor', required
  - `count` integer, required
  - `monthlyCostCents` integer, required
  - `startOffset` integer
  - `rampMonths` integer
  - `position` integer

## Response `200`

Created headcount row

- object
  - `success` boolean
  - `data` ForecastHeadcount
    - `id` string, uuid
    - `forecastId` string, uuid
    - `role` string
    - `employmentType` 'w2' | 'contractor'
    - `count` integer
    - `monthlyCostCents` integer: Monthly cost per head in the model's authoritative minor units
    - `startOffset` integer
    - `rampMonths` integer
    - `position` integer

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member
- `404`: Resource not found
- `422`: Validation error

---

[API](https://skmtc.dev/medianfi/apis/median-api.md) · [All operations](https://skmtc.dev/medianfi/apis/median-api/llms.txt) · [OpenAPI document](https://skmtc.dev/medianfi/apis/median-api/revisions/20090ea32b0d?raw)