Sign in

v3

latestOpenAPI 3.0.0©2023 All Rights Reserved2026-08-0659315450.0 KB
folder

Creates a folder in one of the following locations:

  • The top level of a Canva user's projects (using the ID root),
  • The user's Uploads folder (using the ID uploads),
  • Another folder (using the parent folder's ID).

When a folder is successfully created, the endpoint returns its folder ID, along with other information.

post/v1/folders

Request body

namestring required

The name of the folder.

parent_folder_idstring required

The folder ID of the parent folder. To create a new folder at the top level of a user's projects, use the ID root. To create it in their Uploads folder, use uploads.

Example request

{
  "name": "My awesome holiday",
  "parent_folder_id": "FAF2lZtloor"
}

Response

OK

Example response

{
  "folder": {
    "id": "FAF2lZtloor",
    "name": "My awesome holiday",
    "created_at": 1377396000,
    "updated_at": 1692928800,
    "thumbnail": {
      "width": 595,
      "height": 335,
      "url": "https://document-export.canva.com/Vczz9/zF9vzVtdADc/2/thumbnail/0001.png?<query-string>"
    }
  }
}