---
title: "Create Task"
method: POST
path: "/projects/{project_id}/tasks"
tags: ["Tasks"]
---

# Create Task

`POST /projects/{project_id}/tasks`

Create a task in a project. For tasks coming from connected integrations, sync them via `POST /projects/{project_id}/sync` instead.

## Path parameters

- `project_id` string, required

## Request body

- TaskRequestCreateRequest
  - `name` string, required
  - `section` integer — Section ID
  - `labels` string[]
  - `status` 'open' | 'closed'
  - `color` string — Label color, max 15 chars.
  - `dueOn` string — Due date, format Y-m-d. Send "" to clear.
  - `startOn` string — Start date, format Y-m-d. Send "" to clear.
  - `description` string — Plain-text description, max 2000 chars.
  - `assignees` object[] — Task assignees.
    - `userId` integer
    - `accountId` string
  - `tags` integer[] — Tag IDs, max 10.
  - `fields` object[] — Custom field values.
  - `cover` object
    - `coverId` integer
    - `coverPick` string
  - `placeBefore` string[] — Encoded IDs of tasks to place this one before (create only).

## Response `201`

Created

- Task
  - `id` string, required
  - `name` string, required
  - `projects` string[], required — List of projects ID
  - `section` number, nullable — Section ID
  - `labels` string[]
  - `position` number
  - `description` string, nullable
  - `dueAt` string, nullable — Format: Y-m-d H:i:s
  - `status` 'open' | 'closed'
  - `time` TaskTime
    - `total` number, required — Total task time in seconds
    - `users` object, required — Task time per user ID
  - `estimate` TaskEstimate
    - `total` number, required — Total task estimate in seconds
    - `type` 'overall' | 'users', required
    - `users` object — Task estimate per user ID
  - `attributes` object — Custom attributes from integration
  - `metrics` object — Custom metrics from integration
  - `unbillable` boolean

## Other responses

- `401` — Unauthorized

---

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