---
title: "Create Task"
method: POST
path: "/tasks/create"
tags: ["tasks"]
---

# Create Task

`POST /tasks/create`

This endpoint creates a new task

## Request body

- object
  - `title` string, required — - The title of the task (1–500 characters)
  - `type` 'todo' | 'chat' | 'message' | 'ticket' — - The type of the new task - Possible values: `todo`, `chat`, `message`, `ticket` - Default `todo`
  - `association` object — - Required when `type !== "todo"`. Forbidden when `type === "todo"`. - Must contain exactly one of `chat_id` / `message_id` / `ticket_id`, matching the `type`
    - `chat_id` string — - Required when task `type` is `chat`
    - `message_id` string — - Required when task `type` is `message`
    - `ticket_id` string — - Required when task `type` is `ticket`
  - `status` 'open' | 'inprogress' | 'closed' — - Status of the task - Possible values: `open`, `inprogress`, `closed` - Default `open`
  - `priority` 1 | 2 | 3 — - The priority of the new task - Possible values: `1`, `2`, `3` - Default `1`
  - `assignee` string — - Email of an org member. Validated against your org's member list
  - `due_date` string — - The due date of the new task - Should be in ISO 8601 timestamp format
  - `notes` string — - Free-form text attached to the task
  - `remind_at` string — - The remind date for the task to receive a reminder - Should be in ISO 8601 timestamp format
  - `created_by` string — - Email of an org member. Defaults to `"api"`

## Response `200`

200 OK

- object — The response is a task object. Refer to [the task object here](/api-reference/objects/the-task-object)

---

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