Create a task
Creates a task and optionally assigns it to users and associates it with entities (persons, companies, opportunities, etc.) in a single atomic operation. Returns the new task id on success.
Enum values (case-sensitive, uppercase):
- status: DRAFT | ACTIVE | COMPLETED | ARCHIVED (default: ACTIVE)
- priority: LOW | MEDIUM | HIGH
- visibility: RING (all tenant members) | PERSONAL (creator only, default: RING)
- reminder_type: MINUTES | HOURS | DAYS | WEEKS (requires reminder_value)
Authorizations
Body
List of internal user UUIDs to assign the task to.
Entity type for associated_entity_uuids. Must be one of: PERSON, COMPANY, NOTE, FILE, OPPORTUNITY.
List of entity UUIDs (persons, companies, etc.) to associate with the task.
ISO 8601 date string, e.g. '2025-12-31'.
Task priority. Must be one of: LOW, MEDIUM, HIGH. Omit to leave unset.
LOW, MEDIUM, HIGH Unit for the reminder interval. Must be one of: MINUTES, HOURS, DAYS, WEEKS. Requires reminder_value to be set together.
MINUTES, HOURS, DAYS, WEEKS Numeric amount for the reminder interval (e.g. 30 for 30 minutes).
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.
DRAFT, ACTIVE, COMPLETED, ARCHIVED Visibility scope. RING = visible to all tenant members; PERSONAL = visible only to the creator. Defaults to RING.
RING, PERSONAL