Skip navigation
Skip to main content

Canva concepts

The Canva Connect APIs let your integration interact with various Canva resources. This article explains key concepts that are useful to know when integrating with Canva.

Canva Apps

Canva Apps available in the Canva Apps Marketplace are developed using the Canva Apps SDK. These apps are available to users within the Canva editor, allowing app developers to add new or improved functionally to Canva.

Canva integrations

Canva integrations allow third-party app developers to extend key Canva capabilities off-platform. For example, (Canva for Slack and Canva for ChatGPT). These integrations interact with Canva using the Canva Connect APIs.

An integration is what you develop when using the Canva Connect APIs.

Assets

Assets, known as Uploads in the Canva UI, are user-upload images, audio tracks, and videos. Assets are stored in the user's Projects along with their designs, and users can add their assets, or shared assets, to designs using the Uploads tab in the Canva editor. Users can also add tags to their assets to help them search through their assets.

For Connect API endpoints that interact with assets, see the Assets API reference.

Designs

A design is anything you create in Canva, including:

This doesn't include elements within a design, such as:

  • Images and videos uploaded by a user.
  • Built-in elements, such as shapes and stock images.

Most Canva designs are between 40 × 40 pixels and 8,000 × 8,000 pixels and can have multiple pages, with exceptions for some design types, such as Documents (unlimited length) and Whiteboards (unlimited width and height).

Many Connect API endpoints interact with designs. For more information, see the Designs, Design import, and Design types API references.

Folders

Folders are a collection of items, such as:

  • Other folders.
  • Assets, such as uploaded images, audio, and videos.
  • Designs, such as Instagram posts, Presentations, and Documents (Canva Docs).
  • Brand Templates.

When identifying folders, we recommend using the folder's id, which can't be changed by a user. The top level of the user's content library, Projects, is represented in APIs as a folder with the ID root.

For Connect API endpoints that interact with folders, see the Folders API reference.

Teams, groups, and users

Canva users are organized into organizations, teams, and groups. For Canva Enterprise customers, an Organization is the largest organizational unit, and can contain many teams, groups, and users. For non-enterprise customers, a Team is the largest organizational unit.

Diagram showing that teams can have multiple groups, and users can be members of multiple Groups.
A team (Acme Corp) can have many users and groups, with some users in one or more groups, and some not in a group at all.

All users are in at least one team; including Canva Free and Canva Pro users, who are in their own (individual) teams. Users in a team have access to all content shared with that team and can easily share content with other team members.

Groups belong to a team and can't be shared between two teams. Users don't need to be part of a group, but they can be in one or more groups.

Diagram showing that a user can be in multiple teams, teams can have multiple groups, and users can be members of multiple groups.
Some large organizations have multiple teams, and some users may be in one or more of those teams.