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

# Create task

`POST /task`

## Request

- Base URL: `https://api.breezeway.io/public/inventory/v1`
- URL: `https://api.breezeway.io/public/inventory/v1/task`
- Auth: API key in header `Authorization`

## 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
  - `reported_issue` boolean: Indicates whether the task is a reported issue or not
  - `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-api.md) - [All operations](https://skmtc.dev/breezeway/apis/breezeway-api/llms.txt) - [OpenAPI document](https://skmtc.dev/breezeway/apis/breezeway-api/revisions/557cdcedc1ac?raw)