---
title: "POST /tasks"
method: POST
path: "/tasks"
tags: ["tasks"]
---

# POST /tasks

`POST /tasks`

Create a new task

## Request body

- PostTasks — Create a new task
  - `title` string
  - `color` string
  - `body` string
  - `location` string
  - `is_event` boolean
  - `participants` string
  - `starts_at` string, date-time
  - `ends_at` string, date-time
  - `due_date` string, date-time
  - `remind_at` string, date-time
  - `done` boolean
  - `is_reminder` boolean
  - `broker_id` integer
  - `note_type_id` integer
  - `event_category_id` integer
  - `private` boolean
  - `reservation_reason_id` integer
  - `state` integer
  - `done_at` string, date-time
  - `all_day` boolean
  - `client_source_id` integer
  - `task_type` integer
  - `recurring` boolean
  - `call_data` unknown
  - `direction` integer
  - `source_message_id` integer
  - `booking_calendar_id` integer
  - `rsvp_status` integer
  - `invite` boolean
  - `mass_viewing` boolean
  - `slot_step` integer
  - `max_participants_per_slot` integer
  - `viewing_reply_snippet_id` integer
  - `room_resource_emails` string[]
  - `priority` integer
  - `custom_fields` object — An object containing custom fields and their values. Syntax: {"my_custom_field": "my_custom_value"}. If a value contains quotes, escape them, e.g. {"my_custom_field": "example value \"key\": 0123"}. Unknown custom field names return a validation_error.
  - `access_broker_ids` integer[]
  - `access_department_ids` integer[]
  - `previous_activity_type` string
  - `previous_activity_id` integer
  - `decision_option_id` integer
  - `department_id` integer
  - `review_state` string
  - `reviewer_ids` integer[]
  - `task_stage_id` integer
  - `project_ids` integer[]
  - `property_ids` integer[]
  - `client_ids` integer[]
  - `remind_in_minutes` integer

## Response `201`

Create a new task

- TaskEntity — TaskEntity model
  - `id` integer
  - `task_type` string
  - `title` string
  - `body` string
  - `all_day` boolean
  - `done` boolean
  - `is_event` boolean
  - `is_reminder` boolean
  - `private` boolean
  - `recurring` boolean
  - `last_deal_stage_name` string
  - `location` string
  - `state` string
  - `rrule` string
  - `broker` BrokerEntity — BrokerEntity model
    - `id` integer
    - `first_name` string
    - `last_name` string
    - `salutation` string
    - `academic_title` string
    - `avatar_url` string
    - `position` integer
    - `email` string
    - `color` string
    - `locale` string
    - `description` string
    - `cell` string
    - `phone` string
    - `public_cell` string
    - `public_phone` string
    - `team_id` integer
    - `access_team_ids` integer[]
    - `custom_fields` object
    - `role` 'owner' | 'user' | 'free_user' | 'technical' | 'consulting'
    - `archived` boolean
    - `blocked` boolean
  - `task_creator` BrokerEntity — BrokerEntity model
    - `id` integer
    - `first_name` string
    - `last_name` string
    - `salutation` string
    - `academic_title` string
    - `avatar_url` string
    - `position` integer
    - `email` string
    - `color` string
    - `locale` string
    - `description` string
    - `cell` string
    - `phone` string
    - `public_cell` string
    - `public_phone` string
    - `team_id` integer
    - `access_team_ids` integer[]
    - `custom_fields` object
    - `role` 'owner' | 'user' | 'free_user' | 'technical' | 'consulting'
    - `archived` boolean
    - `blocked` boolean
  - `task_updater` BrokerEntity — BrokerEntity model
    - `id` integer
    - `first_name` string
    - `last_name` string
    - `salutation` string
    - `academic_title` string
    - `avatar_url` string
    - `position` integer
    - `email` string
    - `color` string
    - `locale` string
    - `description` string
    - `cell` string
    - `phone` string
    - `public_cell` string
    - `public_phone` string
    - `team_id` integer
    - `access_team_ids` integer[]
    - `custom_fields` object
    - `role` 'owner' | 'user' | 'free_user' | 'technical' | 'consulting'
    - `archived` boolean
    - `blocked` boolean
  - `note_type` NoteTypeEntity
    - `id` integer
    - `name` string
    - `color` string
    - `is_type` string
    - `item_type` string
    - `display_name` string
  - `client_source` ClientSourceEntity
    - `id` integer
    - `name` string
    - `position` integer
    - `inquiry_department_id` integer
    - `emails` string[]
    - `created_at` string
    - `updated_at` string
  - `attachments` NoteAttachmentEntity[]
    - `id` integer
    - `name` string
    - `url` string
  - `activity_id` integer
  - `broker_id` integer
  - `client_source_id` integer
  - `access_broker_ids` integer[]
  - `access_department_ids` integer[]
  - `broker_ids` integer[]
  - `client_ids` integer[]
  - `group_ids` integer[]
  - `viewing_ids` integer[]
  - `project_ids` integer[]
  - `property_ids` integer[]
  - `custom_fields` object
  - `clients_rsvp` ClientRsvpEntity[]
    - `client_id` integer
    - `attending` boolean
  - `created_at` string
  - `updated_at` string
  - `starts_at` string
  - `ends_at` string
  - `due_date` string

## Other responses

- `400` — validation_error
- `401` — authentication_error
- `403` — authorization_error
- `404` — not_found_error
- `422` — validation_error
- `500` — internal_server_error

---

[API](https://skmtc.net/propstack/apis/propstack-api-v2-beta.md) · [All operations](https://skmtc.net/propstack/apis/propstack-api-v2-beta/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/propstack/propstack-api-v2-beta/revisions/ae1e0fe6da1a/schema)