---
title: "Post Task"
method: POST
path: "/crm/tasks"
tags: ["CRM Service Calls"]
---

# Post Task

`POST /crm/tasks`

Create a new task.

Tasks are work items that can be linked to any CRM entity.

**Request Body (TaskRequest):**

- **name** *(required)*: Task title.
- **description** *(optional)*: Task details.
- **status** *(default: "assigned")*: Values: assigned, in-progress, rejected,
  reviewsubmit, reviewpass, completed.
- **priority** *(optional)*: 1=highest, 4=lowest.
- **due_date** *(optional)*: Epoch timestamp (seconds).
- **subject_type** *(optional)*: Entity type to link. Values: lead, property, contact,
  opportunity, account, insurance_policy, entity_list, none.
- **subject** *(optional)*: Linked entity ObjectId.
- **userid** *(optional)*: Assigned user ID.
- **action** *(default: "general")*: Task type. Values: general, call, email, text,
  postcard, support-request, ambivo-support, work-order, attend-meeting, renewal-reminder.
- **action_data** *(optional)*: Action-specific details (e.g., phone number for a call task).
- **tags** *(optional)*: Up to 10 tags.

**Response:** The created task object.

## Request body

- TaskRequest — Request to create a new task.
  - `name` string, required — Task title
  - `description` string, nullable — Task details
  - `status` string, nullable — Possible values: assigned, in-progress, rejected, reviewsubmit, reviewpass, completed
  - `priority` integer, nullable — Priority 1=highest, 4=lowest
  - `due_date` integer, nullable — Due date (epoch timestamp seconds)
  - `subject_type` string, nullable — Possible values: lead, property, contact, opportunity, account, insurance_policy, entity_list, none
  - `subject` string, nullable — Linked entity ObjectId
  - `userid` string, nullable — Assigned user ID
  - `action` string, nullable — Task type: general, call, email, text, postcard, support-request, ambivo-support, work-order, attend-meeting, renewal-reminder
  - `action_data` object, nullable — Action-specific details (e.g. phone number for call)
  - `tags` string[], nullable — List of tags

## Response `200`

Successful Response

- TaskResponse — Response model for a single task.
  - `id` string, required
  - `name` string, required
  - `description` string, nullable
  - `status` string, nullable
  - `priority` integer, nullable
  - `due_date` string, nullable
  - `is_completed` boolean, nullable
  - `completed_date` string, nullable
  - `subject_type` string, nullable
  - `subject` string, nullable
  - `userid` string, nullable
  - `created_by_userid` string, nullable
  - `action` string, nullable
  - `action_data` object, nullable
  - `tags` string[], nullable
  - `created_date` string, nullable
  - `updated_date` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/ambivo/apis/ambivo-api.md) · [All operations](https://skmtc.net/ambivo/apis/ambivo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ambivo/ambivo-api/versions/165a6d16a9a0/schema)