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

# POST /tasks

`POST /tasks`

## Request body

- union
  - BaseCreateTaskRequest
    - `person_id` string, uuid, required
    - `priority` 'LOW' | 'MEDIUM' | 'HIGH' | 'URGENT'
    - `due_at` string, date-time, nullable
  - BaseCreateTaskRequest
    - `person_id` string, uuid, required
    - `priority` 'LOW' | 'MEDIUM' | 'HIGH' | 'URGENT'
    - `due_at` string, date-time, nullable
  - BaseCreateTaskRequest
    - `person_id` string, uuid, required
    - `priority` 'LOW' | 'MEDIUM' | 'HIGH' | 'URGENT'
    - `due_at` string, date-time, nullable
  - BaseCreateTaskRequest
    - `person_id` string, uuid, required
    - `priority` 'LOW' | 'MEDIUM' | 'HIGH' | 'URGENT'
    - `due_at` string, date-time, nullable
  - BaseCreateTaskRequest
    - `person_id` string, uuid, required
    - `priority` 'LOW' | 'MEDIUM' | 'HIGH' | 'URGENT'
    - `due_at` string, date-time, nullable
  - BaseCreateTaskRequest
    - `person_id` string, uuid, required
    - `priority` 'LOW' | 'MEDIUM' | 'HIGH' | 'URGENT'
    - `due_at` string, date-time, nullable

## Response `201`

The request has succeeded and a new resource has been created as a result.

- CreateTaskResponse — Response for a successful create operation.
  - `status` 'success', required
  - `data` Task, required
    - `id` string, uuid, required
    - `type` 'EMAIL' | 'ACTION_ITEM' | 'PHONE_CALL' | 'LINKEDIN_SEND_MESSAGE' | 'LINKEDIN_SEND_CONNECTION_REQUEST' | 'LINKEDIN_VIEW_PROFILE' | 'REPLY_TO_EMAIL', required
    - `status` 'NOT_READY' | 'READY' | 'COMPLETED' | 'SKIPPED' | 'CANCELED', required
    - `priority` 'LOW' | 'MEDIUM' | 'HIGH' | 'URGENT', required
    - `person_id` string, uuid, required
    - `assigned_user_id` string, uuid, required
    - `due_at` string, date-time, nullable, required
    - `ended_at` string, date-time, nullable, required
    - `note_content` string, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `400` — Response for any operation that results in a bad request error.
- `401` — Response for any operation that results in an unauthorized error.
- `403` — Response for any operation that results in a forbidden error.
- `404` — Response for any operation that results in a not found error.
- `409` — Response for any operation that results in a conflict error.
- `429` — Response for any operation that exceeds a rate limit.
- `500` — Response for any operation that results in an internal server error.

---

[API](https://skmtc.dev/unifygtm/apis/unify-analytics-api.md) · [All operations](https://skmtc.dev/unifygtm/apis/unify-analytics-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/unifygtm/unify-analytics-api/revisions/2f145e6f6d7e/schema)