- Category: images & design
- Auth: OAUTH2
- Composio-managed OAuth available? Yes
- Tools: 53
- Triggers: 0
- Slug:
CANVA - Version: 20261101_00
Frequently Asked Questions
How do I set up custom OAuth credentials for Canva?
How do I set up custom OAuth credentials for Canva?
Tools
Access user specific brand templates list
Access user specific brand templates list
CANVA_ACCESS_USER_SPECIFIC_BRAND_TEMPLATES_LISTLists brand templates available to users on plans with brand-template access, such as Canva Pro, Canva Teams, or Canva Enterprise. Returns one page of template metadata, including IDs and titles. Follow the response’s continuation token to retrieve additional pages. Dataset definitions are available from CANVA_RETRIEVE_BRAND_TEMPLATE_DATASET_DEFINITION.Input Parameters
any: (Default) Brand templates with and without dataset definitions. - non_empty: Brand templates with one or more data fields defined.relevance: (Default) Sort results using a relevance algorithm. - modified_descending: Sort results by the date last modified in descending order. - modified_ascending: Sort results by the date last modified in ascending order. - title_descending: Sort results by title in descending order. - title_ascending: Sort results by title in ascending order.any: (Default) Brand templates owned by and shared with the user. - owned: Brand templates owned by the user. - shared: Brand templates shared with the user./v1/brand-templates?continuation={continuation}. To retrieve all the brand templates available to the user, you might need to make multiple requests. IMPORTANT: This token is an opaque value returned by the API. You must use it exactly as returned from a previous API response. Do not manually construct or modify continuation tokens.Output
Create Asset Upload Job
Create Asset Upload Job
CANVA_CREATE_ASSET_UPLOAD_JOBUploads an asset file to the user’s Canva content library. This endpoint initiates an asynchronous upload job for images or videos. Returns a job ID to track the upload progress. Once complete, the asset can be used in designs, referenced by its asset ID, and managed through other asset endpoints. IMPORTANT: This is an async operation. Use CANVA_FETCH_ASSET_UPLOAD_JOB_STATUS to poll the job status until it reaches ‘success’ or ‘failed’ status.Input Parameters
Output
Create Canva Design Export Job (Deprecated)
Create Canva Design Export Job (Deprecated)
CANVA_CREATE_CANVA_DESIGN_EXPORT_JOBStarts a deprecated asynchronous Canva design export job in PNG, JPG, GIF, PDF, PPTX, MP4, HTML bundle, standalone HTML, or CSV format. Export options vary by format; poll the job for completion and download URLs.Input Parameters
Output
Create canva design with optional asset (Deprecated)
Create canva design with optional asset (Deprecated)
CANVA_CREATE_CANVA_DESIGN_WITH_OPTIONAL_ASSETDEPRECATED: Use CANVA_POST_DESIGNS instead. Creates a new Canva design with specified dimensions or from an asset. This endpoint creates a design using either a preset type (doc, email, presentation, whiteboard), custom dimensions, or by importing an image asset. Returns the design ID, URLs for editing and viewing, owner info, and metadata. The design can be immediately accessed and edited.Input Parameters
Output
Create comment reply in design (Deprecated)
Create comment reply in design (Deprecated)
CANVA_CREATE_COMMENT_REPLY_IN_DESIGNDEPRECATED: Use CANVA_POST_DESIGNS_DESIGNID_COMMENTS_THREADID_REPLIES instead. 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.Input Parameters
[user_id:team_id].Output
Create design comment in preview api (Deprecated)
Create design comment in preview api (Deprecated)
CANVA_CREATE_DESIGN_COMMENT_IN_PREVIEW_APIDEPRECATED: Use CANVA_POST_DESIGNS_DESIGNID_COMMENTS instead. Creates a new comment thread on a Canva design using Canva’s deprecated Create comment API. This preview API allows adding text comments to designs for collaboration and feedback. Returns the created comment with ID, author info, and timestamp. Comments can be replied to using the comment reply endpoint.Input Parameters
Output
Create Design Import Job
Create Design Import Job
CANVA_CREATE_DESIGN_IMPORT_JOBStarts an asynchronous import of an external document or design file into Canva designs, including PDF, Word, PowerPoint, Excel, PSD, and AI files. Returns a job ID for tracking the import; an import can produce multiple designs.Input Parameters
Output
Create design merge job
Create design merge job
CANVA_CREATE_DESIGN_MERGE_JOBStart a preview job that creates or modifies a design using page operations. New designs support page insertion. Existing designs support insert, move, and delete operations. Poll the returned ID with CANVA_GET_DESIGN_MERGE_JOB.Input Parameters
Output
Create Design Resize Job
Create Design Resize Job
CANVA_CREATE_DESIGN_RESIZE_JOBCreates a resized copy of an existing design (Canva Pro/Enterprise only). This endpoint creates a new design with different dimensions from an existing one. The resize operation runs asynchronously and preserves content where possible. Returns a job ID to track progress and retrieve the new design once complete. IMPORTANT: This is an async operation. Use CANVA_RETRIEVE_DESIGN_RESIZE_JOB_STATUS to poll the job status until completion to get the resized design ID and access URLs.Input Parameters
Output
Create URL Asset Upload Job
Create URL Asset Upload Job
CANVA_CREATE_URL_ASSET_UPLOAD_JOBTool to create an asynchronous Canva asset import job from a public URL. Use when you need to import an asset into Canva directly from a publicly accessible URL without S3 choreography.Input Parameters
Output
Delete asset by id
Delete asset by id
Exchange oauth 2 0 access or refresh token
Exchange oauth 2 0 access or refresh token
CANVA_EXCHANGE_OAUTH20_ACCESS_OR_REFRESH_TOKENThe 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.Input Parameters
Output
Fetch asset upload job status
Fetch asset upload job status
CANVA_FETCH_ASSET_UPLOAD_JOB_STATUSRetrieves the status of a direct asset file upload job. Poll until it succeeds or fails; a successful job can return asset ID and metadata, while a failed job can return error details.Input Parameters
Output
Fetch canva connect signing public keys
Fetch canva connect signing public keys
Fetch current user details
Fetch current user details
Fetch design metadata and access information
Fetch design metadata and access information
Get design comment thread replies
Get design comment thread replies
CANVA_GET_DESIGN_COMMENT_REPLIESRetrieves a page of replies for a comment or suggestion thread on a design. Returns up to limit replies (default 50, maximum 100); follow the continuation token to retrieve the rest. This is a preview API. Public integrations that use it cannot pass Canva’s review process.Input Parameters
Output
Get specific design comment reply
Get specific design comment reply
Get design dataset
Get design dataset
Get design export job result
Get design export job result
Get design generation job
Get design generation job
CANVA_GET_DESIGN_GENERATION_JOBRetrieve a design generation job created by the same user and integration. Call repeatedly until the returned status reaches success or failed. The user must have Canva’s design_generation capability. Jobs expire 24 hours after creation, and only the creating user, integration, and team can retrieve them.Input Parameters
Output
Get design merge job
Get design merge job
Get designs designid comments threadid
Get designs designid comments threadid
CANVA_GET_DESIGNS_DESIGNID_COMMENTS_THREADIDRetrieves metadata for a comment or suggestion thread on a design. Use when you need to get details about a specific thread including content, author, timestamps, and status. This is a preview API. Public integrations that use it cannot pass Canva’s review process.Input Parameters
Output
Get design export formats
Get design export formats
Get URL asset upload job status
Get URL asset upload job status
Get URL import job status
Get URL import job status
Get user capabilities
Get user capabilities
Initiate canva design autofill job
Initiate canva design autofill job
CANVA_INITIATE_CANVA_DESIGN_AUTOFILL_JOBCreates an asynchronous autofill job from a brand template or existing design, or updates an existing design in place. Canva Enterprise users are eligible; paid-plan users can use a limited development trial. Poll the returned job ID with CANVA_RETRIEVE_DESIGN_AUTOFILL_JOB_STATUS.Input Parameters
Output
List design pages with pagination
List design pages with pagination
CANVA_LIST_DESIGN_PAGES_WITH_PAGINATIONPreview 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.Input Parameters
offset parameter. Default is 50 pages. Minimum: 1, Maximum: 200.1. Pages are indexed using one-based numbering, so the first page in a design has the index value 1. Minimum: 1, Maximum: 500.Output
List folder items by type with sorting
List folder items by type with sorting
CANVA_LIST_FOLDER_ITEMS_BY_TYPE_WITH_SORTINGLists folder items, including folders, designs, image assets, and brand templates. Brand templates are returned only when explicitly requested in item_types and the user’s plan supports them. Video assets are currently not returned.Input Parameters
created_ascending: Sort results by creation date, in ascending order. - created_descending: Sort results by creation date, in descending order. - modified_ascending: Sort results by the last modified date, in ascending order. - modified_descending: (Default) Sort results by the last modified date, in descending order. - title_ascending: Sort results by title, in ascending order. The title is either the name field for a folder or asset, or the title field for a design. - title_descending: Sort results by title, in descending order. The title is either the name field for a folder or asset, or the title field for a design.brand_template, design, folder, and image. To filter for more than one item type, provide a comma- delimited list./v1/folders/{folderId}/items?continuation={continuation}. To retrieve all the items in a folder, you might need to make multiple requests.Output
List User Designs
List User Designs
CANVA_LIST_USER_DESIGNSLists one page of Canva user design metadata, with search, ownership filtering for owned and shared designs, and sorting options. Use the response continuation token to retrieve further pages.Input Parameters
relevance: (Default) Sort results using a relevance algorithm. - modified_descending: Sort results by the date last modified in descending order. - modified_ascending: Sort results by the date last modified in ascending order. - title_descending: Sort results by title in descending order. - title_ascending: Sort results by title in ascending order.owned: Designs owned by the user. - shared: Designs shared with the user. - any: Designs owned by and shared with the user./v1/designs?continuation={continuation}. To retrieve all of a user”s designs, you might need to make multiple requests. Pass a valid token or omit this parameter entirely. Empty strings are not accepted by the API.Output
Move item to specified folder
Move item to specified folder
CANVA_MOVE_ITEM_TO_SPECIFIED_FOLDERTransfers 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.Input Parameters
Output
Create new Canva design
Create new Canva design
CANVA_POST_DESIGNSCreates a Canva design from a preset type, custom dimensions, an image asset, an existing design, or a brand template; an image asset can also be inserted with a preset or custom type. Copying designs and using brand templates are preview features; returns design ID, edit/view URLs, and metadata.Input Parameters
Output
Post designs designid comments
Post designs designid comments
CANVA_POST_DESIGNS_DESIGNID_COMMENTSCreates a comment thread on a Canva design. Use when you need to add feedback or collaboration comments to a specific design. Rate limited to 100 requests per minute per user. This is a preview API. Public integrations that use it cannot pass Canva’s review process.Input Parameters
Output
Create reply to comment thread
Create reply to comment thread
CANVA_POST_DESIGNS_DESIGNID_COMMENTS_THREADID_REPLIESTool to create a reply to a comment or suggestion thread on a Canva design. Use when you need to respond to existing comments or suggestions. Maximum 100 replies per thread allowed. This is a preview API. Public integrations that use it cannot pass Canva’s review process.Input Parameters
Output
Start design export job
Start design export job
CANVA_POST_EXPORTSStarts a new asynchronous job to export a Canva design file. Use when exporting designs to various formats (PDF, JPG, PNG, GIF, PPTX, MP4, CSV, and HTML). Returns a job ID that can be used to poll for completion status and download URLs. IMPORTANT: Format compatibility varies by design type. Before exporting, use the CANVA_GET_DESIGNS_DESIGNID_EXPORT_FORMATS action to check which formats are supported for the specific design. Attempting to export in an unsupported format will result in a 400 error (e.g., ‘png export not supported for this design type’).Input Parameters
Output
Create folder
Create folder
CANVA_POST_FOLDERSTool to create a folder in Canva. Use when you need to organize designs, assets, or create nested folder structures in a user’s projects or uploads folder.Input Parameters
Output
Create URL Import Job
Create URL Import Job
CANVA_POST_URL_IMPORTSTool to start an asynchronous job to import an external file from a URL as a new design in Canva. Use when you need to import a design from a publicly accessible URL. This is an async operation; poll the job status using the job ID until it reaches ‘success’ or ‘failed’.Input Parameters
Output
Remove folder and move contents to trash
Remove folder and move contents to trash
Retrieve app public key set
Retrieve app public key set
Retrieve asset metadata by id
Retrieve asset metadata by id
Retrieve brand template dataset definition
Retrieve brand template dataset definition
CANVA_RETRIEVE_BRAND_TEMPLATE_DATASET_DEFINITIONGets the dataset definition for a brand template. Available to users on plans with brand-template access, such as Canva Pro, Canva Teams, or Canva Enterprise. Data fields can contain images, text, and charts; chart data is a preview feature.Input Parameters
Output
Retrieve brand template metadata
Retrieve brand template metadata
Retrieve design autofill job status
Retrieve design autofill job status
Retrieve design import job status
Retrieve design import job status
Retrieve Design Resize Job Status
Retrieve Design Resize Job Status
CANVA_RETRIEVE_DESIGN_RESIZE_JOB_STATUSRetrieves the status and results of a design resize job. Polls for design resize job completion status. Use this after CANVA_CREATE_DESIGN_RESIZE_JOB to check the resize progress. Keep polling until status is ‘success’ or ‘failed’. Successful jobs include the new design ID and temporary access URLs.Input Parameters
Output
Retrieve folder details by id
Retrieve folder details by id
Retrieveuserprofiledata
Retrieveuserprofiledata
Revoke oauth tokens
Revoke oauth tokens
CANVA_REVOKE_OAUTH_TOKENSRevoke an access token or refresh token. Revoking a refresh token also revokes 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.Input Parameters
client_id and client_secret as body parameters.cnvca. NOTE: We recommend that you use basic access authentication instead of specifying client_id and client_secret as body parameters.Output
Update folder details by id
Update folder details by id
Validate oauth token properties
Validate oauth token properties
CANVA_VALIDATE_OAUTH_TOKEN_PROPERTIESCheck 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.Input Parameters
client_id and client_secret as body parameters.cnvca. NOTE: We recommend that you use basic access authentication instead of specifying client_id and client_secret as body parameters.