---
title: "Create Approvals (Folder)"
method: POST
path: "/folders/{folderId}/approvals"
tags: ["Approvals"]
---

# Create Approvals (Folder)

`POST /folders/{folderId}/approvals`

Create an approval for folder/project. Creates approval in draft status when no approvers assigned. Otherwise creates in pending status. Approvals created via API will not be affected by workflow automation, e.g. task status will not be automatically transitioned when approval finishes.

<b>Scopes:</b> Default, wsReadWrite

## Path parameters

- `folderId` string, required

## Query parameters

- `description` string — Description
- `dueDate` string — Due date<br>Format: yyyy-MM-dd
- `autoFinishOnApprove` string — Is finish approval automatically when all approvers have approved. Set to true by default
- `autoFinishOnReject` string — Is finish approval automatically when some of approvers have rejected. Set to true by default

## Response `2XX`

success response

- object
  - `data` Approval[]
    - `dueDate` string — Due date, if exists<br>Format: yyyy-MM-dd
    - `description` string — Description
    - `finished` boolean — Is approval finished
    - `updatedDate` string — Update date<br>Format: yyyy-MM-dd'T'HH:mm:ss'Z'
    - `authorId` string
    - `title` string — Title. Empty by default, set via workflow automation or by user on the portal
    - `type` 'FilesOnly' | 'Regular' — * `FilesOnly` * `Regular`
    - `autoFinishOnReject` boolean — Is approval would be finished automatically on reaching Rejected status
    - `folderId` string
    - `finisherId` string
    - `autoFinishOnApprove` boolean — Is approval would be finished automatically on reaching Approved status
    - `decisions` ApprovalDecision[] — Approvers and their decisions
      - `approverId` string, required
      - `comment` string, required — comment
      - `updatedDate` string, required — update date<br>Format: yyyy-MM-dd'T'HH:mm:ss'Z'
      - `status` 'Approved' | 'Rejected' | 'Pending', required — * `Approved` * `Rejected` * `Pending`
    - `attachmentIds` AttachmentId[] — ID of origin version attachments in review
    - `id` string
    - `taskId` string
    - `status` 'Draft' | 'Approved' | 'Rejected' | 'Cancelled' | 'Pending' — * `Draft` * `Approved` * `Rejected` * `Cancelled` * `Pending`
  - `kind` 'accounts' | 'users' | 'contacts' | 'assets' | 'eDiscoveryReport' | 'folders' | 'folderTree' | 'tasks' | 'taskIds' | 'timelogs' | 'timelogCategories' | 'timelogLockPeriods' | 'timetrackerTimers' | 'comments' | 'attachments' | 'url' | 'version' | 'dataExport' | 'dataExportSchema' | 'auditLog' | 'accessRoles' | 'stream' | 'changes' | 'posts' | 'mailSettings' | 'integrationInfo' | 'gmailIntegrationSettings' | 'workTypesForIntegrations' | 'ids' | 'backups' | 'domains' | 'dependencies' | 'workflows' | 'workschedules' | 'workscheduleExclusions' | 'workscheduleUserExclusions' | 'customfields' | 'customfieldIds' | 'customstatuses' | 'invitations' | 'notifications' | 'jobroles' | 'placeholders' | 'groups' | 'session' | 'dashboards' | 'widgets' | 'taskCreationSettings' | 'colors' | 'experiments' | 'topics' | 'topicComments' | 'webhooks' | 'reviews' | 'boards' | 'textSearch' | 'chatChannels' | 'chatMessages' | 'forms' | 'requestForms' | 'request' | 'report' | 'platformWidgets' | 'platformWidgetInstances' | 'spaces' | 'pdf' | 'customerSatisfaction' | 'asyncJob' | 'approvals' | 'highlights' | 'highlightsList' | 'highlightsSettings' | 'highlightsCard' | 'timesheet' | 'timesheetRow' | 'timesheetSubmissionRule' | 'mobileFeatures' | 'mobileSettings' | 'folderBlueprintTree' | 'taskBlueprintTree' | 'feedback' | 'timeline_snapshot' | 'contactIds' | 'bookings' | 'integrateThreshold' | 'hourlyRatesProvision' | 'hourlyRates' | 'projectTeamMembers' | 'contactsHistory' | 'tasksHistory' | 'foldersHistory' | 'activityDigest' | 'workItemTemplates' | 'workTemplates' | 'workItemMetadata' | 'workItem' | 'customItemTypes' | 'verificationCode' | 'views' | 'listView' | 'tableView' | 'userTypes' | 'reactions' | 'externalRequesters' | 'workscheduleCapacityOverrides' | 'userCapacityOverrides' | 'userCapacityExclusions' | 'rollups' | 'requestFormPrefill' | 'userAggregatedCapacity' | 'cascadingFieldSettings'

## Other responses

- `4XX` — client-side error response
- `5XX` — server-side error response

---

[API](https://skmtc.net/wrike/apis/wrike-api.md) · [All operations](https://skmtc.net/wrike/apis/wrike-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wrike/wrike-api/revisions/f1c1279c29d6/schema)