n8n-nodes-canva

Notice: This node was developed independently to facilitate integrations with the Canva public API in n8n. It is not affiliated with, endorsed by, or maintained by Canva Pty Ltd. All mentioned trademarks belong to their respective owners.

To use our Community Node, you need to meet the following requirements:

• N8N version 1.54.4 or higher
• Node.js version 16.0.0 or higher
• Active account on Canva with Connect API access
• Application registered in the Canva Developer Portal

Via n8n Community Nodes:

1. Open your n8n instance
2. Go to Settings → Community Nodes
3. Install the package: n8n-nodes-canva
4. Restart n8n

Via NPM:

npm install n8n-nodes-canva

🔑 Credentials Configuration

This node now uses n8n's native OAuth 2.0 for automatic authentication:

1. Create an integration in the Canva Developer Portal

   • Log in to the Developer Portal
   • Enable MFA (Multi-Factor Authentication) if required
   • Go to "Your Integrations" and click "Create an integration"
   • Choose between "Public" or "Private" integration

2. Configure your integration:

   • Set a name for your integration
   • Copy the Client ID (will be needed in n8n)
   • Generate and save the Client Secret (will be needed in n8n)
   • IMPORTANT: Copy the OAuth redirect URL: [YOUR-URL-BASE]/rest/oauth2-credential/callback

3. ⚠️ CRITICAL SCOPES CONFIGURATION:

   ATTENTION: To avoid the "invalid_scope" error, you MUST enable ALL the scopes listed below in the Scopes section of your integration:

   app:read
   app:write
   asset:read
   asset:write
   brandtemplate:content:read
   brandtemplate:meta:read
   comment:read
   comment:write
   design:content:read
   design:content:write
   design:meta:read
   design:permission:read
   design:permission:write
   folder:read
   folder:write
   folder:permission:read
   folder:permission:write
   profile:read

   🚨 IMPORTANT: Check/enable ALL 18 scopes above in your Canva Developer Portal integration. If any scope is missing, you will receive the "invalid_scope" error during OAuth authentication.

4. In n8n, create a new "Canva API" credential:

   • Client ID: Paste the Client ID obtained from the Developer Portal
   • Client Secret: Paste the Client Secret generated from the Developer Portal
   • Click "Connect my account" to start the OAuth flow
   • Authorize the application on the Canva screen
   • ✅ Done! n8n will automatically manage tokens and renewals

5. 🎯 Native OAuth Advantages:

   • ✅ Simplified configuration - Only Client ID and Secret
   • ✅ Automatic renewal - n8n manages refresh tokens
   • ✅ Enhanced security - No manual tokens exposed
   • ✅ Standard flow - Same experience as other n8n nodes

Migration: If you used previous versions with manual Access Token, delete the old credential and create a new one following the steps above.

📡 Webhook Configuration

To use the Canva Trigger:

1. Add the Canva Trigger node to your workflow
2. Configure the events you want to listen to
3. Activate the workflow
4. The webhook will be automatically registered in Canva
5. When you deactivate the workflow, the webhook will be automatically removed

🚨 Troubleshooting - "invalid_scope" Error

Problem: During OAuth authentication, you receive the error:

Error: Insufficient parameters for OAuth2 callback.
Received following query parameters: {"error":"invalid_scope","error_description":"Requested scopes are not allowed for this client."}

Solution:

1. Access your integration in the Canva Developer Portal
2. Go to the "Your integrations" > "Create an integration" section
3. Go to the "Scopes" section of your integration
4. Check/enable ALL 18 scopes listed in the configuration section above
5. Save the changes
6. Try the OAuth connection again in n8n

Cause: This error occurs when the OAuth2 application in Canva is not configured with all the scopes that n8n-nodes-canva needs to function correctly.

Contribute to the growth of this project! You can help in various ways:

• Pull Requests: Send improvements, corrections, or new functionalities.
• Issues: Report problems or suggest new ideas.
• Suggestions: Share your opinions and feedback.
• Documentation: Help improve or expand the existing documentation.