---
title: "POST /tasks.task.add"
method: POST
path: "/tasks.task.add"
tags: ["tasks"]
---

# POST /tasks.task.add

`POST /tasks.task.add`

## Request body

- object
  - `fields` object, required
    - `title` string, required
    - `description` string
    - `creatorId` integer, required
    - `responsibleId` integer, required
    - `deadline` string, date-time
    - `needsControl` boolean
    - `startPlan` string, date-time
    - `endPlan` string, date-time
    - `fileIds` unknown[]
      - unknown
    - `checklist` unknown[]
      - unknown
    - `groupId` integer
    - `stageId` integer
    - `epicId` integer
    - `storyPoints` integer
    - `flowId` integer
    - `priority` string
    - `status` string
    - `statusChanged` string, date-time
    - `parentId` integer
    - `containsChecklist` boolean
    - `containsSubTasks` boolean
    - `containsRelatedTasks` boolean
    - `containsGanttLinks` boolean
    - `containsPlacements` boolean
    - `containsResults` boolean
    - `numberOfReminders` integer
    - `chatId` integer
    - `plannedDuration` integer
    - `actualDuration` integer
    - `durationType` string
    - `started` string, date-time
    - `estimatedTime` integer
    - `replicate` boolean
    - `changed` string, date-time
    - `changedById` integer
    - `statusChangedById` integer
    - `closedById` integer
    - `closed` string, date-time
    - `activity` string, date-time
    - `guid` string
    - `xmlId` string
    - `exchangeId` string
    - `exchangeModified` string
    - `outlookVersion` integer
    - `mark` string
    - `allowsChangeDeadline` boolean
    - `allowsTimeTracking` boolean
    - `matchesWorkTime` boolean
    - `addInReport` boolean
    - `isMultitask` boolean
    - `siteId` string
    - `forkedByTemplateId` integer
    - `deadlineCount` integer
    - `declineReason` string
    - `forumTopicId` integer
    - `link` string
    - `rights` unknown[]
      - unknown
    - `archiveLink` string
    - `crmItemIds` unknown[]
      - unknown
    - `reminders` unknown[]
      - unknown
    - `requireResult` boolean
    - `matchesSubTasksTime` boolean
    - `autocompleteSubTasks` boolean
    - `allowsChangeDatePlan` boolean
    - `emailId` integer
    - `maxDeadlineChangeDate` string, date-time
    - `maxDeadlineChanges` integer
    - `requireDeadlineChangeReason` boolean
    - `inFavorite` unknown[]
      - unknown
    - `inPin` unknown[]
      - unknown
    - `inGroupPin` unknown[]
      - unknown
    - `inMute` unknown[]
      - unknown
    - `dependsOn` unknown[]
      - unknown
    - `scenarios` unknown[]
      - unknown

## Response `200`

Success response

- object
  - `result` object
    - `item` BitrixTasksTaskdto
      - `id` integer
      - `title` string
      - `description` string
      - `creatorId` integer
      - `creator` BitrixTasksUserdto
        - `id` integer
        - `name` string
        - `role` string
        - `image` BitrixTasksFiledto
          - `id` integer
          - `src` string
          - `name` string
          - `width` integer
          - `height` integer
          - `size` integer
          - `subDir` string
          - `contentType` string
          - `file` unknown[]
            - unknown
        - `gender` string
        - `email` string
        - `externalAuthId` string
        - `rights` unknown[]
          - unknown
      - `created` string, date-time
      - `responsibleId` integer
      - `responsible` BitrixTasksUserdto
        - `id` integer
        - `name` string
        - `role` string
        - `image` BitrixTasksFiledto
          - `id` integer
          - `src` string
          - `name` string
          - `width` integer
          - `height` integer
          - `size` integer
          - `subDir` string
          - `contentType` string
          - `file` unknown[]
            - unknown
        - `gender` string
        - `email` string
        - `externalAuthId` string
        - `rights` unknown[]
          - unknown
      - `deadline` string, date-time
      - `needsControl` boolean
      - `startPlan` string, date-time
      - `endPlan` string, date-time
      - `fileIds` unknown[]
        - unknown
      - `checklist` unknown[]
        - unknown
      - `groupId` integer
      - `group` BitrixTasksGroupdto
        - `id` integer
        - `name` string
        - `image` BitrixTasksFiledto
          - `id` integer
          - `src` string
          - `name` string
          - `width` integer
          - `height` integer
          - `size` integer
          - `subDir` string
          - `contentType` string
          - `file` unknown[]
            - unknown
        - `type` string
        - `isVisible` boolean
      - `stageId` integer
      - `stage` BitrixTasksStagedto
        - `id` integer
        - `title` string
        - `color` string
      - `epicId` integer
      - `storyPoints` integer
      - `flowId` integer
      - `flow` BitrixTasksFlowdto
        - `id` integer
        - `name` string
      - `priority` string
      - `status` string
      - `statusChanged` string, date-time
      - `accomplices` BitrixTasksUserdto[]
        - `id` integer
        - `name` string
        - `role` string
        - `image` BitrixTasksFiledto
          - `id` integer
          - `src` string
          - `name` string
          - `width` integer
          - `height` integer
          - `size` integer
          - `subDir` string
          - `contentType` string
          - `file` unknown[]
            - unknown
        - `gender` string
        - `email` string
        - `externalAuthId` string
        - `rights` unknown[]
          - unknown
      - `auditors` BitrixTasksUserdto[]
        - `id` integer
        - `name` string
        - `role` string
        - `image` BitrixTasksFiledto
          - `id` integer
          - `src` string
          - `name` string
          - `width` integer
          - `height` integer
          - `size` integer
          - `subDir` string
          - `contentType` string
          - `file` unknown[]
            - unknown
        - `gender` string
        - `email` string
        - `externalAuthId` string
        - `rights` unknown[]
          - unknown
      - `parentId` integer
      - `parent` BitrixTasksTaskdto — recursive
      - `containsChecklist` boolean
      - `containsSubTasks` boolean
      - `containsRelatedTasks` boolean
      - `containsGanttLinks` boolean
      - `containsPlacements` boolean
      - `containsResults` boolean
      - `numberOfReminders` integer
      - `chatId` integer
      - `chat` BitrixTasksChatdto
        - `id` integer
        - `entityId` integer
        - `entityType` string
      - `plannedDuration` integer
      - `actualDuration` integer
      - `durationType` string
      - `started` string, date-time
      - `estimatedTime` integer
      - `replicate` boolean
      - `changed` string, date-time
      - `changedById` integer
      - `changedBy` BitrixTasksUserdto
        - `id` integer
        - `name` string
        - `role` string
        - `image` BitrixTasksFiledto
          - `id` integer
          - `src` string
          - `name` string
          - `width` integer
          - `height` integer
          - `size` integer
          - `subDir` string
          - `contentType` string
          - `file` unknown[]
            - unknown
        - `gender` string
        - `email` string
        - `externalAuthId` string
        - `rights` unknown[]
          - unknown
      - `statusChangedById` integer
      - `statusChangedBy` BitrixTasksUserdto
        - `id` integer
        - `name` string
        - `role` string
        - `image` BitrixTasksFiledto
          - `id` integer
          - `src` string
          - `name` string
          - `width` integer
          - `height` integer
          - `size` integer
          - `subDir` string
          - `contentType` string
          - `file` unknown[]
            - unknown
        - `gender` string
        - `email` string
        - `externalAuthId` string
        - `rights` unknown[]
          - unknown
      - `closedById` integer
      - `closedBy` BitrixTasksUserdto
        - `id` integer
        - `name` string
        - `role` string
        - `image` BitrixTasksFiledto
          - `id` integer
          - `src` string
          - `name` string
          - `width` integer
          - `height` integer
          - `size` integer
          - `subDir` string
          - `contentType` string
          - `file` unknown[]
            - unknown
        - `gender` string
        - `email` string
        - `externalAuthId` string
        - `rights` unknown[]
          - unknown
      - `closed` string, date-time
      - `activity` string, date-time
      - `guid` string
      - `xmlId` string
      - `exchangeId` string
      - `exchangeModified` string
      - `outlookVersion` integer
      - `mark` string
      - `allowsChangeDeadline` boolean
      - `allowsTimeTracking` boolean
      - `matchesWorkTime` boolean
      - `addInReport` boolean
      - `isMultitask` boolean
      - `siteId` string
      - `forkedByTemplateId` integer
      - `forkedByTemplate` BitrixTasksTemplatedto
        - `id` integer
        - `task` BitrixTasksTaskdto — recursive
        - `title` string
        - `description` string
        - `creator` BitrixTasksUserdto
          - `id` integer
          - `name` string
          - `role` string
          - `image` BitrixTasksFiledto
            - `id` integer
            - `src` string
            - `name` string
            - `width` integer
            - `height` integer
            - `size` integer
            - `subDir` string
            - `contentType` string
            - `file` unknown[]
              - …
          - `gender` string
          - `email` string
          - `externalAuthId` string
          - `rights` unknown[]
            - unknown
        - `responsibleCollection` unknown[]
          - unknown
        - `deadlineAfterTs` integer
        - `startDatePlanTs` integer
        - `endDatePlanTs` integer
        - `replicate` boolean
        - `fileIds` unknown[]
          - unknown
        - `checklist` unknown[]
          - unknown
        - `group` BitrixTasksGroupdto
          - `id` integer
          - `name` string
          - `image` BitrixTasksFiledto
            - `id` integer
            - `src` string
            - `name` string
            - `width` integer
            - `height` integer
            - `size` integer
            - `subDir` string
            - `contentType` string
            - `file` unknown[]
              - …
          - `type` string
          - `isVisible` boolean
        - `priority` string
        - `accomplices` unknown[]
          - unknown
        - `auditors` unknown[]
          - unknown
        - `parent` BitrixTasksTemplatedto — recursive
        - `replicateParams` BitrixTasksReplicateparamsdto
          - `period` string
          - `everyDay` string
          - `workdayOnly` string
          - `dailyMonthInterval` string
          - `everyWeek` string
          - `monthlyType` string
          - `monthlyDayNum` string
          - `monthlyMonthNum1` string
          - `monthlyWeekDayNum` string
          - `monthlyWeekDay` string
          - `monthlyMonthNum2` string
          - `yearlyType` string
          - `yearlyDayNum` string
          - `yearlyMonth1` string
          - `yearlyWeekDayNum` string
          - `yearlyWeekDay` string
          - `yearlyMonth2` string
          - `time` string
          - `timezoneOffset` string
          - `startDate` string
          - `repeatTill` string
          - `endDate` string
          - `times` string
      - `deadlineCount` integer
      - `declineReason` string
      - `forumTopicId` integer
      - `tags` BitrixTasksTagdto[]
        - `id` integer
        - `name` string
        - `ownerId` integer
        - `owner` BitrixTasksUserdto
          - `id` integer
          - `name` string
          - `role` string
          - `image` BitrixTasksFiledto
            - `id` integer
            - `src` string
            - `name` string
            - `width` integer
            - `height` integer
            - `size` integer
            - `subDir` string
            - `contentType` string
            - `file` unknown[]
              - …
          - `gender` string
          - `email` string
          - `externalAuthId` string
          - `rights` unknown[]
            - unknown
        - `groupId` integer
        - `group` BitrixTasksGroupdto
          - `id` integer
          - `name` string
          - `image` BitrixTasksFiledto
            - `id` integer
            - `src` string
            - `name` string
            - `width` integer
            - `height` integer
            - `size` integer
            - `subDir` string
            - `contentType` string
            - `file` unknown[]
              - …
          - `type` string
          - `isVisible` boolean
        - `taskId` integer
        - `task` BitrixTasksTaskdto — recursive
      - `link` string
      - `userFields` BitrixTasksUserfielddto[]
        - `id` integer
        - `key` string
        - `value` unknown
      - `rights` unknown[]
        - unknown
      - `archiveLink` string
      - `crmItemIds` unknown[]
        - unknown
      - `crmItems` BitrixTasksCrmitemdto
        - `id` integer
        - `type` string
        - `title` string
      - `reminders` unknown[]
        - unknown
      - `elapsedTime` BitrixTasksElapsedtimedto
        - `id` integer
        - `userId` integer
        - `taskId` integer
        - `minutes` integer
        - `seconds` integer
        - `source` string
        - `text` string
        - `createdAtTs` integer
        - `startTs` integer
        - `stopTs` integer
      - `requireResult` boolean
      - `matchesSubTasksTime` boolean
      - `autocompleteSubTasks` boolean
      - `allowsChangeDatePlan` boolean
      - `emailId` integer
      - `email` BitrixTasksEmaildto
        - `id` integer
        - `taskId` integer
        - `mailboxId` integer
        - `title` string
        - `body` string
        - `from` string
        - `dateTs` integer
        - `link` string
      - `maxDeadlineChangeDate` string, date-time
      - `maxDeadlineChanges` integer
      - `requireDeadlineChangeReason` boolean
      - `inFavorite` unknown[]
        - unknown
      - `inPin` unknown[]
        - unknown
      - `inGroupPin` unknown[]
        - unknown
      - `inMute` unknown[]
        - unknown
      - `source` BitrixTasksSourcedto
        - `type` string
        - `data` unknown[]
          - unknown
      - `dependsOn` unknown[]
        - unknown
      - `scenarios` unknown[]
        - unknown

---

[API](https://skmtc.net/bitrix24/apis/bitrix24-rest-v3-api.md) · [All operations](https://skmtc.net/bitrix24/apis/bitrix24-rest-v3-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitrix24/bitrix24-rest-v3-api/versions/3660cc6bfaf5/schema)