Canva
Learn how to use Canva with Composio
Overview
Enum
CANVA
Description
Canva offers a drag-and-drop design suite for creating social media graphics, presentations, and marketing materials with prebuilt templates and a vast element library
Authentication Details
OAUTH2
Actions
CANVA_RETRIEVE_CANVA_ENTERPRISE_BRAND_TEMPLATE_METADATA
Upcoming update will change brand template ids; integrations must migrate within 6 months. api use requires canva enterprise membership.
Action Parameters
Action Response
CANVA_CREATE_CANVA_DESIGN_WITH_OPTIONAL_ASSET
Create a new canva design using a preset or custom dimensions, and add an asset with asset id
from a user’s project using relevant apis.
Action Parameters
Action Response
CANVA_VALIDATE_OAUTH_TOKEN_PROPERTIES
Check an access token’s validity and properties via introspection, requiring authentication. use basic access (base64 encoded client id:client secret
) or body parameters for credentialing.
Action Parameters
Action Response
CANVA_ACCESS_USER_SPECIFIC_BRAND_TEMPLATES_LIST
This year, brand template ids will change; integrations storing them must update within 6 months. also, api use requires canva enterprise membership.
Action Parameters
Action Response
CANVA_CREATE_COMMENT_REPLY_IN_DESIGN
This preview api allows replying to comments within a design on canva, with a limit of 100 replies per comment. users should note potential unannounced changes, and that preview apis are not eligible for public integrations.
Action Parameters
Action Response
CANVA_MOVE_ITEM_TO_SPECIFIED_FOLDER
Transfers an item to a different folder by specifying both the destination folder’s id and the item’s id. if the item is in various folders, an error occurs; manual relocation via canva ui is required.
Action Parameters
Action Response
CANVA_REVOKE_OAUTH_TOKENS
Revoke a refresh token to end its lineage and user consent, requiring re-authentication. authenticate using either basic access with base64-encoded credentials or body parameters with client id and secret.
Action Parameters
Action Response
CANVA_RETRIEVE_A_SPECIFIC_DESIGN_COMMENT
This preview api is subject to unannounced changes and can’t be used in public integrations. it retrieves a comment, details of which are on canva help center.
Action Parameters
Action Response
CANVA_EXCHANGE_OAUTH_2_0_ACCESS_OR_REFRESH_TOKEN
The oauth 2.0 endpoint issues time-limited (4-hour) access tokens of up to 4kb for user authorization via codes or refresh tokens. it requires client id/secret for authentication.
Action Parameters
Action Response
CANVA_GET_DESIGN_EXPORT_JOB_RESULT
Get the outcome of a canva design export job; if done, receive download links for the design’s pages. for details, visit the create design export job api documentation.
Action Parameters
Action Response
CANVA_CREATE_USER_OR_SUB_FOLDER
This api creates a folder in a canva user’s projects at the top level or within another folder, returning the new folder’s id and additional details upon success.
Action Parameters
Action Response
CANVA_REMOVE_FOLDER_AND_MOVE_CONTENTS_TO_TRASH
Deletes a folder by moving the user’s content to trash and reassigning other users’ content to their top-level projects.
Action Parameters
Action Response
CANVA_RETRIEVE_USER_PROFILE_DATA
Currently, this returns the display name of the user account associated with the provided access token. more user information is expected to be included in the future.
Action Parameters
Action Response
CANVA_FETCH_CURRENT_USER_DETAILS
Returns the user id, team id, and display name of the user account associated with the provided access token.
Action Parameters
Action Response
CANVA_LIST_DESIGN_PAGES_WITH_PAGINATION
Preview api for canva: subject to unannounced changes and not for public integrations. lists metadata for design pages with optional offset
and limit
; not applicable to all design types.
Action Parameters
Action Response
CANVA_CREATE_DESIGN_COMMENT_IN_PREVIEW_API
This api is in preview and may change without notice; integrations using it won’t pass review. it allows creating comments on a design, with a limit of 1000 comments per design.
Action Parameters
Action Response
CANVA_DELETE_ASSET_BY_ID
You can delete an asset by specifying its assetid
. this operation mirrors the behavior in the canva ui. deleting an item moves it to the trash. deleting an asset doesn’t remove it from designs that already use it.
Action Parameters
Action Response
CANVA_FETCH_CANVA_CONNECT_SIGNING_PUBLIC_KEYS
The api for verifying canva webhooks, ‘connect/keys,’ is in preview, meaning unstable, not for public integrations, and provides a rotating jwk for signature verification to prevent replay attacks. cache keys for efficiency.
Action Parameters
Action Response
CANVA_INITIATES_CANVA_DESIGN_EXPORT_JOB
Canva’s new job feature exports designs in multiple formats using a design id, with provided download links. the export status can be tracked via an api. exports with ‘pro’ quality may fail if the design contains unpaid premium elements.
Action Parameters
Action Response
CANVA_INITIATE_CANVA_DESIGN_AUTOFILL_JOB
Upcoming brand template id updates require migration within 6 months. canva enterprise users can auto-fill designs using various data types, including experimental chart data. monitor jobs with specific api.
Action Parameters
Action Response
CANVA_LIST_FOLDER_ITEMS_BY_TYPE_WITH_SORTING
Lists the items in a folder, including each item’s type
. folders can contain: - other folders. - designs, such as instagram posts, presentations, and documents (canva docs). - image assets.
Action Parameters
Action Response
CANVA_UPDATE_FOLDER_DETAILS_BY_ID
Updates a folder’s details using its folderid
. currently, you can only update a folder’s name.
Action Parameters
Action Response
CANVA_RETRIEVE_ASSET_METADATA_BY_ID
You can retrieve the metadata of an asset by specifying its assetid
.
Action Parameters
Action Response
CANVA_FETCH_ASSET_UPLOAD_JOB_STATUS
Summarize asset upload outcome by repeatedly calling the endpoint until a ‘success’ or ‘failed’ status is received after using the create asset upload job api.
Action Parameters
Action Response
CANVA_UPDATE_ASSET_S_NAME_AND_TAGS_BY_ID
You can update the name and tags of an asset by specifying its assetid
. updating the tags replaces all existing tags of the asset.
Action Parameters
Action Response
CANVA_LIST_CANVA_USER_DESIGN_METADATA_WITH_FILTERS_AND_SORTING
Provides a summary of canva user designs, includes search filtering, and allows showing both self-created and shared designs with sorting options.
Action Parameters
Action Response
CANVA_RETRIEVE_DESIGN_AUTOFILL_JOB_STATUS
Api users with canva enterprise membership can retrieve design autofill job results, potentially requiring multiple requests until a success
or failed
status is received.
Action Parameters
Action Response
CANVA_RETRIEVE_FOLDER_DETAILS_BY_ID
Gets the name and other details of a folder using a folder’s folderid
.
Action Parameters
Action Response
CANVA_RETRIEVE_BRAND_TEMPLATE_DATASET_DEFINITION
Canva’s brand template ids will change later this year, including a 6-month integration migration. api access requires enterprise membership, providing autofill for images, text, and charts, although chart data could change during preview.
Action Parameters
Action Response
CANVA_RETRIEVE_APP_PUBLIC_KEY_SET
Returns the json web key set (public keys) of an app. these keys are used to verify jwts sent to app backends.
Action Parameters
Action Response
CANVA_RETRIEVE_DESIGN_IMPORT_JOB_STATUS
Gets the status and results of design import jobs created using the create design import job api.
Action Parameters
Action Response
CANVA_FETCH_DESIGN_METADATA_AND_ACCESS_INFORMATION
Gets the metadata for a design. this includes owner information, urls for editing and viewing, and thumbnail information.
Action Parameters
Action Response