---
title: "Create a new budget_line_item"
method: POST
path: "/api/v3/projects/{project_id}/budget_line_items"
tags: ["budget line items"]
---

# Create a new budget_line_item

`POST /api/v3/projects/{project_id}/budget_line_items`

## Path parameters

- `project_id` string, uuid, required

## Headers

- `Fieldwire-Version` string, date, required

## Request body

- BudgetLineItemCreateInput — Schema for creating a Budget Line Item
  - `budget_line_item` object — Entity that represents a line item in the budget table.
    - `tier_two_cost_code_id` string, uuid, required — ID of the tier two cost code to which the budget line item belongs
    - `cost_type` 'materials' | 'labor' | 'equipment' | 'subcontractor' | 'other' | 'cost_markup', required — The category for budget and expenses of the line item
    - `original_budget` string, numeric, required — Expected maximum amount of currency set by the lead company for use under the line item.
    - `creator_user_id` integer, required — ID of the user who created this entity
    - `last_editor_user_id` integer, required — ID of the user who most recently edited this entity

## Response `201`

Successful response

- BudgetLineItem — Entity that represents a line item in the budget table.
  - `id` string, uuid, required — ID of the budget line item
  - `creator_user_id` integer, required — ID of the user who created this entity
  - `last_editor_user_id` integer, required — ID of the user who most recently edited this entity
  - `project_id` string, uuid, required — ID of the project this entity belongs to
  - `tier_one_cost_code_id` string, uuid, required — ID of the tier one cost code to which the budget line item belongs
  - `tier_two_cost_code_id` string, uuid, required — ID of the tier two cost code to which the budget line item belongs
  - `cost_type` 'materials' | 'labor' | 'equipment' | 'subcontractor' | 'other' | 'cost_markup', required — The category for budget and expenses of the line item
  - `original_budget` string, required — Expected maximum amount of currency set by the lead company for use under the line item.
  - `current_budget` string, required — The sum of the original budget and amount of currency added by approved lead company change orders.
  - `pending_budget` string, nullable, required — The sum of the amount of currency to be added to current budget if pending lead company change orders are approved.
  - `actual_cost` string, nullable, required — The amount of currency paid out under the line item.
  - `current_over_under` string, required — The difference between the current budget and the current cost.
  - `assignee_pm_group_id` string, uuid, nullable, required — The id of the subcontractor company assigned to make expense change orders under this budget line item.
  - `original_cost` string, nullable, required — Amount of currency set aside by the lead company to be paid out to others under the line item.
  - `projected_cost` string, nullable, required — Amount of currency expected to be paid out to others under the line item
  - `current_cost` string, nullable, required — The sum of the original cost and amount of currency added by approved subcontractor company change orders.
  - `pending_cost` string, nullable, required — The sum of the amount of currency to be added to current cost if pending subcontractor company change orders are approved.
  - `actual_over_under` string, nullable, required — The difference between the current budget and the actual cost.
  - `projected_over_under` string, required — The variance between the current budget and projected final cost, indicating whether the project is forecasted to be over budget (negative) or under budget (positive).
  - `assignee_pm_group_name` string, nullable, required — The name of the subcontractor company assigned to make expense change orders under this budget line item.
  - `device_created_at` string, date-time, required — Time when the device created the entity
  - `device_updated_at` string, date-time, required — Time when the device last updated the entity
  - `created_at` string, date-time, required — Time when the server created the entity
  - `updated_at` string, date-time, required — Time when the server last updated the entity
  - `deleted_at` string, date-time, nullable, required — Time the server deleted the entity

---

[API](https://skmtc.dev/fieldwire/apis/fieldwire-super-api.md) · [All operations](https://skmtc.dev/fieldwire/apis/fieldwire-super-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fieldwire/fieldwire-super-api/revisions/66ee1c20b92d/schema)