Create Task (Folder)

post

https://www.wrike.com/api/v4/folders/{folderId}/tasks

Create a task in a folder. The folder specified by {folderId} will become the 'parent' folder for the new task. To create a task in the account root, use the Root Folder API ID. When creating a subtask, use the Root API ID as {folderId} and specify the parent task in the 'superTasks' parameter.

Scopes: Default, wsReadWrite

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

folderId

string

required

Query Params

title

string

required

Title of task, required

description

string

Description of task, will be left blank, if not set

status

string

enum

Status of task. Not available for the Team plan

Active - Active
Deferred - Deferred
Completed - Completed
Cancelled - Cancelled

Allowed:

importance

string

enum

Importance of task

High
Low
Normal

Allowed:

dates

object

Task dates. If not specified, a backlogged task is created

shareds

array of objects

Shares task with specified users or invitations. The task is always shared with the author.

shareds

parents

array of objects

Parent folders for newly created task. Can not contain recycleBinId

parents

responsibles

array of strings

Makes specified users or invitations assignee for the task

responsibles

responsiblePlaceholders

array of objects

Makes specified placeholders assignee for the task

responsiblePlaceholders

followers

array of strings

Add specified users to task followers

followers

boolean

Follow task

priorityBefore

string

Put newly created task before specified task in task list

priorityAfter

string

Put newly created task after specified task in task list

superTasks

array of strings

Add the task as subtask to specified tasks

superTasks

metadata

array of objects

length ≤ 100

Metadata to be added to newly created task. Limit : 100

metadata

customFields

array of objects

length ≤ 100

List of custom fields to set in newly created task. Limit : 100

customFields

customStatus

string

Custom status ID

effortAllocation

object

Set Task Effort fields: mode, total Effort

billingType

string

enum

Task's timelogs billing type

Billable - Billable
NonBillable - Non-Billable

Allowed:

withInvitations

boolean

Include invitations in sharedIds & responsibleIds lists

customItemTypeId

string

Custom Item Type ID to create a task from

plainTextCustomFields

boolean

Strip HTML tags from custom fields

workScheduleId

string

Id of work schedule to assign to task

fields

array of strings

Json string array of optional fields to be included in the response model

customItemTypeId - Custom Item Type ID
billingType - Billing type
workScheduleId - Id of work schedule assigned to task
effortAllocation - Effort Allocation
responsiblePlaceholderIds - List of placeholder assignee IDs

fields

Responses

2XXsuccess response

4XXclient-side error response

5XXserver-side error response