---
title: "Create a task"
method: POST
path: "/api/v2/tasks"
tags: ["Tasks"]
---

# Create a task

`POST /api/v2/tasks`

Creates a task inside a task list. Requires `title`, `project_id`, `task_list_id`, and `workflow_status_id`. To create the task as a subtask of another task, also set `parent_task_id`.

```json
{
  "data": {
    "type": "tasks",
    "attributes": {
      "title": "Draft Q3 launch plan",
      "project_id": 31002,
      "task_list_id": 7781,
      "workflow_status_id": 101,
      "assignee_id": 5634,
      "due_date": "2026-06-15"
    }
  }
}
```

## Headers

- `X-Organization-Id` string, required

## Response `201`

Single task

## Other responses

- `422` — Unprocessable Entity

---

[API](https://skmtc.net/productive/apis/api-documentation.md) · [All operations](https://skmtc.net/productive/apis/api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/productive/api-documentation/versions/6bb0150a5c5f/schema)