---
title: "Create task"
method: POST
path: "/task"
---

# Create task

`POST /task`

## Request body

- object
  - `home_id` integer — Property ID from Breezeway system (required if referece_property_id is omitted)
  - `reference_property_id` integer — Property ID from external system (required if home_id is omitted)
  - `name` string, required — Name of task
  - `type_department` 'housekeeping' | 'inspection' | 'maintenance' | 'safety'
  - `type_priority` 'urgent' | 'high' | 'normal' | 'low' | 'watch'
  - `description` string — Description of task
  - `template_id` integer — Template ID from Breezeway system
  - `scheduled_date` string, date — Date task is scheduled; ISO 8601 format
  - `scheduled_time` string — Time task is scheduled; ISO 8601 format (HH:MM:SS)
  - `assignments` integer[] — Array of person IDs from Breezeway system
  - `tags` integer[] — Array of task tag IDs from Breezeway system
  - `subdepartment_id` integer — Subdepartment ID from Breezeway system
  - `rate_paid` number, float — Rate paid
  - `rate_type` ''hourly'' | ''piece'' — Rate type
  - `requested_by` ''owner'' | ''guest'' | ''guest_survey'' | ''inspector'' | ''housekeeper'' | ''maintenance_tech'' | ''property_services'' | ''property_manager'' | ''damage'' | ''internal'' | ''insurance'' | ''dispatcher'' | ''review'' — Type of entity that made the request
  - `assign_default_workers` boolean — When set to true, it will assign task with default workers, prioritizing assignees from template, then by department. Default assignees will be added to any manually sent assignees

## Response `201`

201

## Other responses

- `422` — 422

---

[API](https://skmtc.dev/breezeway/apis/breezeway-auth-api.md) · [All operations](https://skmtc.dev/breezeway/apis/breezeway-auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/breezeway/breezeway-auth-api/revisions/920ab5205e9d/schema)