Skip to main content
POST
Create a new task for the caller's tenant.

Authorizations

x-api-key
string
header
required

Body

application/json
title
string
required
assigned_to_uuids
string[]

List of internal user UUIDs to assign the task to.

associated_entity_type
string | null

Entity type for associated_entity_uuids. Must be one of: PERSON, COMPANY, NOTE, FILE, OPPORTUNITY.

associated_entity_uuids
string[]

List of entity UUIDs (persons, companies, etc.) to associate with the task.

content
Content · object | null
due_date
string | null

ISO 8601 date string, e.g. '2025-12-31'.

priority
enum<string> | null

Task priority. Must be one of: LOW, MEDIUM, HIGH. Omit to leave unset.

Available options:
LOW,
MEDIUM,
HIGH
reminder_type
enum<string> | null

Unit for the reminder interval. Must be one of: MINUTES, HOURS, DAYS, WEEKS. Requires reminder_value to be set together.

Available options:
MINUTES,
HOURS,
DAYS,
WEEKS
reminder_value
integer | null

Numeric amount for the reminder interval (e.g. 30 for 30 minutes).

status
enum<string> | null

Task status. Must be one of: DRAFT (not yet started), ACTIVE (in progress), COMPLETED (done), ARCHIVED (soft-deleted from view). Defaults to ACTIVE when omitted on create.

Available options:
DRAFT,
ACTIVE,
COMPLETED,
ARCHIVED
visibility
enum<string>
default:RING

Visibility scope. RING = visible to all tenant members; PERSONAL = visible only to the creator. Defaults to RING.

Available options:
RING,
PERSONAL

Response

201 - application/json

Minimal response body for task create/update.

id
string
required
created_at
string | null
updated_at
string | null