Skip to main content
POST
Create task

Authorizations

X-API-Key
string
header
required

Your Flozy API key. Starts with flz_live_.

Body

application/json
title
string
required
Required string length: 1 - 500
Example:

"Send proposal"

description
string | null
status
enum<integer>
default:1

1 todo · 2 in progress · 3 completed · 4 in review. String representations (e.g. "1") are also accepted.

Available options:
1,
2,
3,
4
priority
enum<integer>
default:2

1 low · 2 medium · 3 high. String representations (e.g. "2") are also accepted.

Available options:
1,
2,
3
due_date
string | null

Calendar date as YYYY-MM-DD. A full ISO 8601 date-time (2026-01-31T10:00:00Z) is also accepted and truncated to its date part — the timezone offset is ignored, so 2026-01-31T23:00:00-05:00 stores 2026-01-31. The column is a SQL DATE, so no time is ever kept. Any other value, including an impossible date such as 2026-02-30, is rejected with a validation error naming the field and the accepted formats. Send null for no due date.

Example:

"2026-05-01"

start_date
string | null

Calendar date as YYYY-MM-DD. A full ISO 8601 date-time (2026-01-31T10:00:00Z) is also accepted and truncated to its date part — the timezone offset is ignored, so 2026-01-31T23:00:00-05:00 stores 2026-01-31. The column is a SQL DATE, so no time is ever kept. Any other value, including an impossible date such as 2026-02-30, is rejected with a validation error naming the field and the accepted formats. Send null for no start date.

Example:

"2026-04-20"

lead_id
integer | null
Example:

42

parent_task_id
integer | null

Response

Task created.