---
title: "Create new task"
method: POST
path: "/tasks"
tags: ["[v1] Task"]
---

# Create new task

`POST /tasks`

Create new task. To ceate new task you should have proper permissions.

## Request body

- object
  - `name` string, required — task name
  - `tags` string — comma separated tags' names
  - `parent_id` union — task parent id
    - string
    - integer
  - `external_task_id` string — external task id ie. id of task in other system/integration
  - `external_parent_id` string — external parent id ie. id of parent task in other system/integration
  - `budgeted` integer — task budget value, defined in the unit specified by `budget_unit`
  - `note` string — description for task
  - `archived` integer — is task archived
  - `billable` 0 | 1 — is task billable
  - `budget_unit` 'hours' | 'fee' — budget unit: `hours`, `fee` or empty
  - `user_ids` string — comma separated user ids to add to task
  - `role` integer — works only if `user_ids` are provided - sets given role to given `user_ids` in created task
  - `keywords` string — comma separated keywords

## Response `201`

Created

- object
  - `[task_id]` object
    - `task_id` union
      - string
      - integer
    - `parent_id` union
      - string
      - integer
    - `name` string
    - `external_task_id` union
      - string
      - integer
    - `external_parent_id` union
      - string
      - integer
    - `level` union
      - string
      - integer
    - `add_date` string
    - `archived` union
      - string
      - integer
    - `color` string
    - `tags` string
    - `budgeted` union
      - string
      - integer
    - `checked_date` string, nullable
    - `root_group_id` union
      - string
      - integer
    - `assigned_to` union
      - string
      - integer
    - `assigned_by` union
      - string
      - integer
    - `due_date` string, nullable
    - `note` string, nullable
    - `context` string, nullable
    - `folder` string, nullable
    - `repeat` union
      - string
      - integer
    - `billable` union
      - string
      - integer
    - `budget_unit` string
    - `public_hash` string, nullable
    - `modify_time` string, nullable
    - `keywords` string

## Other responses

- `400` — Bad Request

---

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