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

# Create a new task

`POST /tasks`

Creates a new task. The task will be assigned to the user associated with your API key.

## Request body

- object
  - `title` string, required — Task title
  - `description` string — Task description
  - `type` 'call' | 'todo' | 'meeting' — Task type
  - `status` 'OPEN' | 'IN_PROGRESS' | 'ON_HOLD' | 'COMPLETED' | 'CANCELLED' — Task status
  - `dueDate` string, date-time — Due date for the task
  - `startDate` string, date-time — Start date for the task
  - `priority` 'LOW' | 'MEDIUM' | 'HIGH' — Task priority
  - `entity` 'leads' | 'deals' | 'clients' — Entity type to associate the task with
  - `entityId` string — Public ID of the entity to associate the task with

## Response `200`

OK

- object
  - `id` string, required — Task public ID
  - `number` string, required — Auto-generated task number
  - `title` string, required — Task title
  - `description` string, nullable — Task description
  - `status` string, required — Task status
  - `type` string, required — Task type
  - `priority` string, nullable — Task priority
  - `dueDate` string, date-time, nullable — Due date
  - `startDate` string, date-time, nullable — Start date
  - `createdAt` string, date-time, required — When the task was created

---

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