Canva
API actions for the Canva integration.
Canva
Create, edit, and publish designs in Canva.
Create a Canva design
Create a new design in Canva with a specified type, dimensions, and optional title.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
design_type | string | Yes | Design type: 'doc', 'whiteboard', 'presentation', or 'custom' (requires width/height). |
title | string | No | Optional title for the design (1-255 characters). |
width | number | No | Width in pixels (40-8000) for custom design type. |
height | number | No | Height in pixels (40-8000) for custom design type. |
asset_id | string | No | Optional image asset ID to insert into the design. |
Response
{
"id": "DAFVcK_N123",
"title": "My New Design",
"urls": {
"edit_url": "https://www.canva.com/design/DAFVcK_N123/edit",
"view_url": "https://www.canva.com/design/DAFVcK_N123/view"
}
}Export a Canva design
Export a Canva design to a file format like PDF, PNG, JPG, or MP4.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
design_id | string | Yes | The ID of the design to export. |
format_type | string | No | Export format: 'pdf', 'jpg', 'png', 'gif', 'pptx', or 'mp4'. |
quality | string | No | Quality setting for jpg ('regular' or 'pro') or pdf export. |
width | number | No | Optional export width (respects aspect ratio). |
height | number | No | Optional export height (respects aspect ratio). |
pages | array | No | Optional list of page numbers to export (1-indexed). |
Response
{
"design_id": "DAFVcK_N123",
"job_id": "export_job_123abc",
"status": "in_progress"
}Get design details
Retrieve details about a specific Canva design.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
design_id | string | Yes | The ID of the design to retrieve. |
Response
{
"created_at": "2024-01-15T10:30:00Z",
"id": "DAFVcK_N123",
"owner": {
"team_id": "team_456",
"user_id": "user_123"
},
"title": "My Design",
"updated_at": "2024-01-16T14:45:00Z",
"urls": {
"edit_url": "https://www.canva.com/design/DAFVcK_N123/edit",
"view_url": "https://www.canva.com/design/DAFVcK_N123/view"
}
}Get export job status
Check the status and results of a Canva export job.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
job_id | string | Yes | The export job ID returned from export_design. |
Response
{
"job_id": "export_job_123abc",
"status": "success",
"urls": [
"https://export.canva.com/export_job_123abc/design.png"
]
}List Canva designs
List designs owned by the authenticated Canva user.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | No | Optional search query to filter designs. |
continuation | string | No | Continuation token for pagination. |
Response
{
"continuation": "next_page_token_xyz",
"designs": [
{
"id": "DAFVcK_N123",
"thumbnail": {
"url": "https://thumbnail.canva.com/123.png"
},
"title": "My First Design"
},
{
"id": "DAFVcK_N456",
"thumbnail": {
"url": "https://thumbnail.canva.com/456.png"
},
"title": "My Second Design"
}
]
}