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

# Create task

`POST /tasks`

Creates a new task in [VTEX DO](https://help.vtex.com/en/tutorial/vtex-do--7KMbRL4OslN8DTX9oiuCiu).

## Permissions

This endpoint does not require [License Manager resources](https://help.vtex.com/en/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3).

## Headers

- `Content-Type` string, required
- `Accept` string, required

## Request body

- object
  - `target` object[], required — Target information for creating the task.
    - `id` string, required — Order ID.
    - `type` string, required — Task type.
    - `url` string, required — Order ID link in VTEX Admin.
  - `domain` string, required — Task domain in the VTEX environment.
  - `context` string, required — Task context.
  - `name` string, required — Task name.
  - `priority` string, required — Task level of priority.
  - `surrogateKey` string, nullable, required — [Surrogate key](https://www.ibm.com/docs/en/ida/9.1?topic=keys-surrogate) unique identifier of the task.
  - `description` string — Additional task comment.
  - `dueDate` string, required — Task deadline in `hh:mm:ss` format.
  - `assignee` object, required — Assignee to whom the task will be designated.
    - `id` string, nullable — Task assignee ID.
    - `name` string, nullable — Task assignee name.
    - `email` string, required — Task assignee email.
  - `followers` object[], required — Task follower array.
    - `id` string, nullable — ID of the user designated to be the task follower.
    - `name` string, nullable — Name of the user designated to be the task follower.
    - `email` string, required — Email of the user designated to be the task follower.
  - `parentTaskId` string, nullable — Parent task ID of another task related the task being created, when applicable.

## Response `200`

OK

- unknown

## Changes

> 53 revisions in range; 18 could not be searched.

- **2024-06-21** `a297dc0d5d17` — 7 breaking
  - the request property `surrogateKey` became not nullable
  - the request property `assignee/id` became required
  - the request property `assignee/name` became required
  - the request property `description` became required
  - …3 more

[Change history](https://skmtc.dev/vtex/apis/vtex-do-api/changes/tasks/post.md)

---

[API](https://skmtc.dev/vtex/apis/vtex-do-api.md) · [All operations](https://skmtc.dev/vtex/apis/vtex-do-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vtex/vtex-do-api/revisions/606bdad07f53/schema)