folder

Changed on

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

  • Base URL: https://api.canva.com/rest
  • URL: https://api.canva.com/rest/v1/folders
  • Auth: OAuth 2 (authorization code, authorization URL https://www.canva.com/api/oauth/authorize, token URL https://api.canva.com/rest/v1/oauth/token, scopes: folder:write)

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>"
    }
  }
}

Changes

  • 40ca7f6a753bRevision changes
    • warning

      added the new user_linked_to_another_idp enum value to the response property for the response status

    • warning

      added the new user_linked_to_another_idp enum value to the response property for the response status

    • warning

      added the new user_linked_to_another_idp enum value to the response property for the response status

    • warning

      added the new user_linked_to_another_idp enum value to the response property for the response status

  • 5ea5a3f48e72Revision changes
    • warning

      added the new asset_not_ready enum value to the response property for the response status

    • warning

      added the new asset_not_ready enum value to the response property for the response status

    • warning

      added the new asset_not_ready enum value to the response property for the response status

    • warning

      added the new asset_not_ready enum value to the response property for the response status