Canva
Canva is a web and mobile application designed to help users create, design, and collaborate on visual content.
Categories: Productivity and Collaboration
Type: canva/v1
Connections
Version: 1
OAuth2 Authorization Code
Properties
| Name | Label | Type | Description | Required |
|---|---|---|---|---|
| clientId | Client id | STRING | true | |
| clientSecret | Client secret | STRING | true |
Connection Setup
Find Client ID and Secret
- Navigate to Canva Developers page.
- Click on Create an integration.
- Choose type of the integration and click on Create Integration.
- Click on Scopes.
- Select following scopes:
- asset:read
- asset:write
- design:content:read
- design:content:write
- design:meta:read
- Click on Authentication.
- Enter a redirect URI, e.g.,
https://app.bytechef.io/callback,http://127.0.0.1:5173/callback. - Click on Configuration.
- Click on Generate secret.
- Copy Client ID and Secret.
- Save changes.
Actions
Create Design
Name: createDesign
Create a Canva design.
Properties
| Name | Label | Type | Description | Required |
|---|---|---|---|---|
| type | Type | STRING Optionspreset, custom | true | |
| name | Name | STRING Optionsdoc, email, presentation, whiteboard | The name of the design type. | true |
| width | Width | INTEGER | The width of the design, in pixels. | true |
| height | Height | INTEGER | The height of the design, in pixels. | true |
| title | Title | STRING | The name of the design. | false |
| asset_id | Asset Id | STRING | The ID of an asset to insert into the created design. | false |
Example JSON Structure
{
"label" : "Create Design",
"name" : "createDesign",
"parameters" : {
"type" : "",
"name" : "",
"width" : 1,
"height" : 1,
"title" : "",
"asset_id" : ""
},
"type" : "canva/v1/createDesign"
}Output
Type: OBJECT
Properties
| Name | Type | Description |
|---|---|---|
| id | STRING | The design ID. |
| owner | OBJECT Properties{STRING(user_id), STRING(team_id)} | |
| URLs | ARRAY Items[STRING(edit_url), STRING\(view_url)] | |
| created_at | DATE_TIME | When the design was created in Canva. |
| updated_at | DATE_TIME | When the design was last updated in Canva. |
| title | STRING | The design title. |
| thumbnail | OBJECT Properties{INTEGER(width), INTEGER(height), STRING(url)} | A thumbnail image representing the object. |
| page_count | INTEGER | The total number of pages in the design. |
Output Example
{
"id" : "",
"owner" : {
"user_id" : "",
"team_id" : ""
},
"URLs" : [ "", "" ],
"created_at" : "2021-01-01T00:00:00",
"updated_at" : "2021-01-01T00:00:00",
"title" : "",
"thumbnail" : {
"width" : 1,
"height" : 1,
"url" : ""
},
"page_count" : 1
}Find Asset ID
To find the Asset ID, click here.
Export Design
Name: exportDesign
Get the status and results of an export job, including link(s) to the downloadable file(s).
Properties
| Name | Label | Type | Description | Required |
|---|---|---|---|---|
| design_id | Design ID | STRING | The design ID. | true |
| type | Type | STRING Optionspdf, jpg, png, pptx, gif, mp4, html_bundle, html_standalone | true | |
| quality | Quality | INTEGER | The quality of the exported JPEG that determines how compressed the exported file should be. | true |
| video_quality | Video quality | STRING Optionshorizontal_480p, horizontal_720p, horizontal_1080p, horizontal_4k, vertical_480p, vertical_720p, vertical_1080p, vertical_4k | The orientation and resolution of the exported video. | true |
| export_quality | Export quality | STRING Optionsregular, pro | Specifies the export quality of the design. | false |
| width | Width | INTEGER | Specify the width in pixels of the exported image. | false |
| height | Height | INTEGER | Specify the height in pixels of the exported image. | false |
| size | Size | STRING Optionsa4, a3, letter, legal | The paper size of the export PDF file. | false |
| lossless | Lossless | BOOLEAN Optionstrue, false | If set to true (default), the PNG is exported without compression. | false |
| transparent_background | Transparent background | BOOLEAN Optionstrue, false | If set to true, the PNG is exported with a transparent background. | false |
| as_single_image | As single image | BOOLEAN Optionstrue, false | When true, multi-page designs are merged into a single image. | false |
| pages | Pages | ARRAY Items[INTEGER] | To specify which pages to export in a multi-page design. | false |
Example JSON Structure
{
"label" : "Export Design",
"name" : "exportDesign",
"parameters" : {
"design_id" : "",
"type" : "",
"quality" : 1,
"video_quality" : "",
"export_quality" : "",
"width" : 1,
"height" : 1,
"size" : "",
"lossless" : false,
"transparent_background" : false,
"as_single_image" : false,
"pages" : [ 1 ]
},
"type" : "canva/v1/exportDesign"
}Output
Type: OBJECT
Properties
| Name | Type | Description |
|---|---|---|
| id | STRING | The export job ID. |
| status | STRING | The export status of the job. |
| URLs | ARRAY Items[STRING] | Download URL(s) for the completed export job. |
Output Example
{
"id" : "",
"status" : "",
"URLs" : [ "" ]
}Find Design ID
To find the Design ID, click here.
Upload Asset
Name: uploadAsset
Get the status and results of an upload asset job.
Properties
| Name | Label | Type | Description | Required |
|---|---|---|---|---|
| asset_name | Asset name | STRING | The asset's name. | true |
| asset | Asset | FILE_ENTRY | Asset to upload. | true |
Example JSON Structure
{
"label" : "Upload Asset",
"name" : "uploadAsset",
"parameters" : {
"asset_name" : "",
"asset" : {
"extension" : "",
"mimeType" : "",
"name" : "",
"url" : ""
}
},
"type" : "canva/v1/uploadAsset"
}Output
Type: OBJECT
Properties
| Name | Type | Description |
|---|---|---|
| job | OBJECT Properties{STRING(id), STRING(status), {STRING(id), STRING(type), STRING(name), [STRING](tags), {STRING(user_id), STRING(team_id)}(owner), STRING(created_at), STRING(updated_at), {STRING(width), STRING(height), STRING(url)}(thumbnail)}(asset)} |
Output Example
{
"job" : {
"id" : "",
"status" : "",
"asset" : {
"id" : "",
"type" : "",
"name" : "",
"tags" : [ "" ],
"owner" : {
"user_id" : "",
"team_id" : ""
},
"created_at" : "",
"updated_at" : "",
"thumbnail" : {
"width" : "",
"height" : "",
"url" : ""
}
}
}
}What to do if your action is not listed here?
If this component doesn't have the action you need, you can use Custom Action to create your own. Custom Actions empower you to define HTTP requests tailored to your specific requirements, allowing for greater flexibility in integrating with external services or APIs.
To create a Custom Action, simply specify the desired HTTP method, path, and any necessary parameters. This way, you can extend the functionality of your component beyond the predefined actions, ensuring that you can meet all your integration needs effectively.
Additional Instructions
How to Find Your Canva Design ID
-
Open your design in Canva.
-
Look at the URL in your browser. It will look similar to:
https://www.canva.com/design/DAF123abcXYZ/edit
The Design ID is a part after /design/ of the URL (DAF123abcXYZ in this example).
How to Find Your Canva Asset ID
-
Navigate to the asset you uploaded (e.g., image, video, or file) from Projects, Uploads, or within a design in Canva.
-
Click on the asset to open its preview or use it inside a design.
-
Look at the URL in your browser. It will look similar to:
https://www.canva.com/uploads/Msd59349ff
The Asset ID is the value at the end of the URL (Msd59349ff in this example).
How is this guide?
Last updated on
Calendly
Calendly is a scheduling tool that allows users to easily set up and manage appointments and meetings.
Capsule CRM
Capsule CRM is a cloud-based customer relationship management platform designed to help businesses manage contacts, track sales opportunities, and collaborate with their teams efficiently.