Scopes - Canva Connect APIs Documentation

Connect APIs

Overview API requests & responses Authentication Canva concepts Quick start

API reference

Authentication Folders Assets Designs Design imports Design types Comments Exports Keys Current user

Webhooks

Appendix

The scope parameter specifies the kind of access that your client needs. The list of possible scopes used in Canva Connect API are listed below:

Scope	Description
`asset:read`	View the metadata for the user's assets, such as uploaded images.
`asset:write`	Upload, update, or delete assets on the user's behalf.
`brandtemplate:content:read`	Read the content of the brand templates associated with the user's brand.
`brandtemplate:meta:read`	View the metadata of the brand templates associated with the user's brand.
`collaboration:event`	Receive webhook notifications about events relevant to the user.
`comment:read`	View the comments on the user's designs, and the associated metadata.
`comment:write`	Create comments and replies on the user's designs.
`design:content:read`	View the contents of the user's designs.
`design:content:write`	Create designs on the user's behalf.
`design:meta:read`	View the metadata of the user's designs.
`design:permission:read`	View the permissions assigned to a user's designs.
`design:permission:write`	Set, update, or remove the permissions assigned to the user's designs.
`folder:permission:read`	View permissions assigned to a user's folders.
`folder:permission:write`	Set, update, or remove permissions assigned to the user's folders.
`folder:read`	View the metadata and contents of the user's folders, including their Projects folder.
`folder:write`	Add, move, or remove the user's folders. It also lets you edit folder metadata, such as the folder's name.
`profile:read`	Read a user's profile and account information.

For example, if you just require your client to read design metadata, you can use the design:meta:read scope. If you require your client to read designs, as well as write to any folder, you can use both the design:meta:read and the folder:write scopes.