Canva Connect API - Design Automation & Export

Automate Canva designs with the Connect API. Create designs, manage assets, export to PDF/PNG/JPG/MP4, autofill brand templates, and organize folders. Perfect for marketing automation and design workflows.

BYOK (Bring Your Own Key) -- you provide your own API credentials.

---

Before You Start

This actor requires your own API credentials to fetch real data.

Where to get your key: Canva OAuth access token. Get this by setting up a Canva Connect integration.

You can test with Demo Mode first (free, no key needed) to see the output format before committing.

---

Quick Start

Test with Demo Mode (free, no API key needed)

{
  "demoMode": true,
  "assetUrl": "https://example.com"
}

Run with real data

{
  "demoMode": false,
  "task": "list_designs",
  "accessToken": "YOUR_API_KEY_HERE",
  "designType": "instagram_post",
  "exportFormat": "png",
  "exportQuality": 90,
  "assetUrl": "https://example.com",
  "autofillData": {},
  "maxResults": 20,
  "batchDesignIds": []
}

---

Input Parameters

Parameter	Type	Default	Required	Description
task	string	"list_designs"	Yes*	Operation to perform
accessToken	string	-	Yes*	Canva OAuth access token. Get this by setting up a Canva Connect integration.
designId	string	-	No	Canva design ID for get/export/autofill operations
assetId	string	-	No	Canva asset ID for get/delete operations
folderId	string	-	No	Canva folder ID for folder operations
brandTemplateId	string	-	No	Brand template ID for autofill operations (Enterprise)
designTitle	string	-	No	Title for new design
designType	string	"instagram_post"	No	Preset design type or 'custom' for custom dimensions
customWidth	integer	-	No	Width in pixels for custom design type
customHeight	integer	-	No	Height in pixels for custom design type
exportFormat	string	"png"	No	Format for design export
exportQuality	integer	90	No	Export quality (1-100, for jpg/png)
exportPages	string	-	No	Specific page numbers to export (comma-separated, e.g., '1,2,3'). Leave empty for all pages.
assetUrl	string	-	No	URL to upload as an asset
assetName	string	-	No	Name for the uploaded asset
folderName	string	-	No	Name for new folder
parentFolderId	string	-	No	Parent folder ID for creating nested folders
autofillData	object	{}	No	JSON object with data to autofill into brand template
searchQuery	string	-	No	Search term for filtering designs or templates
maxResults	integer	20	No	Maximum number of results to return
batchDesignIds	array	[]	No	Array of design IDs for batch export
webhookUrl	string	-	No	URL to send results to (Zapier, Make, n8n, etc.)
demoMode	boolean	true	No	Run with sample data (no access token required)

*Required when Demo Mode is off.

---

Pricing

This actor uses pay-per-event billing:

Event	Description	Price
API Request	Each Canva Connect API request processed	$0.01

Demo mode is free -- no charges for sample data.

---

Troubleshooting

"API key is required"

You have Demo Mode turned off but didn't provide an API key. Either:

• Turn Demo Mode on to test with sample data
• Add your API key in the input

"API error 403" or "Unauthorized"

Your API key is invalid, expired, or doesn't have access to this specific API endpoint. Double-check your key and account permissions.

"API error 429" or "Rate limit"

Too many requests. Wait a minute and try again, or reduce the number of items per run.

No results or empty dataset

Check the run log for error messages. Common causes:

• Invalid input format (check the examples above)
• API key without proper permissions
• The target data doesn't exist or is too small to track

How do I test without an API key?

Enable Demo Mode in the input. This returns realistic sample data so you can verify the output format works for your workflow.

---

Built by John Rippy | Actor Arsenal