Canva Skill
by @jiangwill2023
Create, export, upload assets to, and manage Canva designs via the Canva Connect API. Use when the user wants to create social posts, posters, PPT/slide visu...
clawhub install canva-skillπ About This Skill
name: canva-skill description: Create, export, upload assets to, and manage Canva designs via the Canva Connect API. Use when the user wants to create social posts, posters, PPT/slide visuals, export Canva designs as PNG/JPG/PDF, list recent Canva designs, upload local images to Canva, or autofill brand templates with content.
Canva Skill
Use Canva Connect API for design creation, export, and asset upload workflows.
Prerequisites
Create a Canva Integration: 1. Go to https://www.canva.com/developers/ 2. Create a new integration 3. Get your Client ID and Client Secret
Set environment variables:
export CANVA_CLIENT_ID="your_client_id"
export CANVA_CLIENT_SECRET="your_client_secret"
Authenticate on first use and store tokens in ~/.canva/tokens.json.
API Base URL
https://api.canva.com/rest/v1
Authentication
Get access token from local token file:
ACCESS_TOKEN=$(cat ~/.canva/tokens.json | jq -r '.access_token')
Refresh tokens automatically when the auth flow supports it.
Core Operations
List Designs
curl -s "https://api.canva.com/rest/v1/designs" \
-H "Authorization: Bearer $ACCESS_TOKEN" | jq .
Get Design Details
curl -s "https://api.canva.com/rest/v1/designs/{designId}" \
-H "Authorization: Bearer $ACCESS_TOKEN" | jq .
Create Design from Template
curl -X POST "https://api.canva.com/rest/v1/autofills" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"brand_template_id": "TEMPLATE_ID",
"data": {
"title": {"type": "text", "text": "Your Title"},
"body": {"type": "text", "text": "Your body text"}
}
}'
Export Design
Start export job:
curl -X POST "https://api.canva.com/rest/v1/exports" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"design_id": "DESIGN_ID",
"format": {"type": "png", "width": 1080, "height": 1080}
}'
Check export status:
curl -s "https://api.canva.com/rest/v1/exports/{jobId}" \
-H "Authorization: Bearer $ACCESS_TOKEN" | jq .
Upload Asset
curl -X POST "https://api.canva.com/rest/v1/asset-uploads" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/octet-stream" \
-H 'Asset-Upload-Metadata: {"name": "my-image.png"}' \
--data-binary @image.png
List Brand Templates
curl -s "https://api.canva.com/rest/v1/brand-templates" \
-H "Authorization: Bearer $ACCESS_TOKEN" | jq .
Export Formats
Common Workflows
Create Instagram Post
1. List brand templates 2. Find an Instagram post template 3. Autofill with content 4. Export as PNG 1080x1080 5. Download exported fileCreate Carousel
1. Create multiple designs using autofill 2. Export each as PNG 3. Combine for postingBatch Export
1. List designs 2. Loop through and export each 3. Download all filesError Handling
Handle common errors clearly:
Required Scopes
design:content:readdesign:content:writeasset:readasset:writebrandtemplate:content:readTips
Current Status
This local skill skeleton is installed in the workspace, but Canva API use is not ready until the integration credentials and first-time OAuth authentication are completed.
βοΈ Configuration
Create a Canva Integration: 1. Go to https://www.canva.com/developers/ 2. Create a new integration 3. Get your Client ID and Client Secret
Set environment variables:
export CANVA_CLIENT_ID="your_client_id"
export CANVA_CLIENT_SECRET="your_client_secret"
Authenticate on first use and store tokens in ~/.canva/tokens.json.