---
title: "Create task"
method: POST
path: "/v1/platform/businesses/{business_id}/tasks/"
tags: ["Task Management"]
---

# Create task

`POST /v1/platform/businesses/{business_id}/tasks/`

## Request

- Base URL: `https://docs.thredfi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.thredfi.com/v1/platform/businesses/{business_id}/tasks/`
- Auth: one of:
  - HTTP bearer
  - HTTP basic
  - HTTP bearer
  - HTTP bearer

Create a new task with first question (atomic creation)

## Path parameters

- `business_id` string, required

## Request body

- TaskCreateRequest: Serializer for creating tasks with atomic first question.
  - `title` string, required
  - `description` string
  - `accounting_period` string, uuid, nullable: Associated accounting period for monthly grouping
  - `due_date` string, date, nullable: Optional due date for task completion
  - `related_entity_type` string: Model name of related entity (e.g., 'banktransaction', 'invoice', 'bill')
  - `related_entity_id` string, uuid: ID of related entity
  - `first_question` string, required: Initial question from accountant (creates first TaskMessage)
  - `metadata` unknown

## Response `201`

- TaskCreate: Serializer for creating tasks with atomic first question.
  - `title` string, required
  - `description` string
  - `accounting_period` string, uuid, nullable: Associated accounting period for monthly grouping
  - `due_date` string, date, nullable: Optional due date for task completion
  - `metadata` unknown

---

[API](https://skmtc.dev/thredfi/apis/thredfi-accounting-platform-api.md) - [All operations](https://skmtc.dev/thredfi/apis/thredfi-accounting-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/thredfi/apis/thredfi-accounting-platform-api/revisions/0c1918254db3?raw)