---
title: "Create a new project"
method: POST
path: "/projects"
tags: ["Projects"]
---

# Create a new project

`POST /projects`

Creates a new project for a client

## Request body

- object
  - `client_id` integer, required
  - `project_name` string, required
  - `type` 'hourly' | 'fixed' | 'non-billable', required
  - `project_status` 'active' | 'proposed' | 'completed' | 'on hold' | 'archived' | 'canceled'
  - `project_start` string, date
  - `project_end` string, date
  - `budget` number
  - `budget_reset` 'weekly' | 'monthly' | 'quarterly' | 'yearly'
  - `track_unbilled_hours_expected_revenue` boolean
  - `custom_task_rates` object

## Response `200`

Project created successfully

- Project — Project resource
  - `id` integer
  - `team_id` integer
  - `client_id` integer, nullable
  - `name` string
  - `type` 'hourly' | 'fixed' | 'non-billable'
  - `status` 'active' | 'proposed' | 'completed' | 'on hold' | 'archived' | 'canceled' | 'inactive'
  - `start` string, nullable
  - `end` string, nullable
  - `start_date` string, date, nullable
  - `end_date` string, date, nullable
  - `budget` number, nullable
  - `budget_used` number
  - `budget_remaining` number
  - `budget_reset` 'weekly' | 'monthly' | 'quarterly' | 'yearly', nullable
  - `track_unbilled_hours_expected_revenue` boolean
  - `track_unbilled_fixed_expected_revenue` boolean
  - `total_hours_recorded` number
  - `hours` number
  - `hours_budget` string
  - `hours_recorded` string
  - `hours_budget_percentage` number
  - `collected` number
  - `cost` number
  - `profit` number
  - `actual_rate` number
  - `client` object
    - `id` integer, nullable
    - `name` string
  - `users` object[]
    - `id` integer
    - `name` string
    - `avatar` string, nullable

## Other responses

- `401` — Unauthenticated
- `422` — Validation error

---

[API](https://skmtc.net/harpoonapp/apis/harpoon-api-documentation.md) · [All operations](https://skmtc.net/harpoonapp/apis/harpoon-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/harpoonapp/harpoon-api-documentation/revisions/e8fd192f94c6/schema)