---
title: "Create a task"
method: POST
path: "/v1/tasks/create"
tags: ["tasks"]
---

# Create a task

`POST /v1/tasks/create`

Creates a task and assigns it to one or more prospects. Supported task types are Email (1), LinkedIn (2), and General (13). To create a task for a single prospect, provide <code>prospectId</code>. To create the same task for multiple prospects at once, provide <code>prospectIds</code> as an array — the response will include a results array with the outcome per prospect, so a failure for one does not affect the others.

## Request body

- CreateTaskDto
  - `prospectIds` string[], required — List of prospect IDs to create the task for. Pass a single-element array for one prospect, or multiple IDs to create the same task for several prospects in one request.
  - `taskType` '2' | '3' | '4' | '5' | '6' | '9' | '11' | '12' | '13' | '14' | '15' | '16' | '17' | '18', required — The type of task. Accepted values: "2" = LinkedIn connection request, "3" = LinkedIn message, "4" = LinkedIn InMail, "5" = LinkedIn view profile, "6" = LinkedIn post interaction, "9" = Custom, "11" = Call introduction, "12" = Call demo, "13" = Call follow-up, "14" = Call reminder, "15" = Call other, "16" = WhatsApp message, "17" = WhatsApp voice message, "18" = WhatsApp voice call.
  - `priority` '1' | '2' | '3' | '4' — The priority level of the task. Accepted values: "1" = Urgent, "2" = High, "3" = Medium, "4" = Low. Defaults to no priority if not provided.
  - `dueDate` string — The due date for the task in YYYY-MM-DD format (e.g. "2026-04-22"). Defaults to today if not provided.
  - `taskNote` string — An optional note or description to attach to the task.

## Response `201`

Task created successfully

- unknown

## Other responses

- `400` — 1001: Invalid token<br><br>
- `500` — 5001: Internal server error, please try again later<br><br>

---

[API](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy.md) · [All operations](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/saleshandy/develop-with-saleshandy/revisions/fdaa0f2dcdfb/schema)