Description
n8n-nodes-canva
Este Community Node é uma solução 100% gratuita, criada com o intuito de simplificar e auxiliar toda a comunidade a integrar e utilizar ao máximo os principais recursos oferecidos pela Canva Connect API em seus projetos no N8N.
Aviso: Este node foi desenvolvido de forma independente para facilitar integrações com a API pública da Canva no n8n.
Não é afiliado, endossado ou mantido pela Canva Pty Ltd.
Todas as marcas citadas pertencem aos seus respectivos proprietários.
⚙️ Requisitos
Para utilizar o nosso Community Node, é necessário atender aos seguintes requisitos:
- N8N na versão 1.54.4 ou superior
- Node.js na versão 16.0.0 ou superior
- Conta ativa na Canva com acesso à Connect API
- Application registrada no Canva Developer Portal
📌 Recursos Disponíveis
🎨 Designs
✨ Este recurso oferece acesso completo às principais funcionalidades relacionadas ao gerenciamento de designs no Canva. Ele permite criar novos projetos, buscar designs existentes, listar seus trabalhos e gerenciar todo o ciclo de vida dos designs de forma prática e eficiente.
Lista de operações
✅ Criar Design
✅ Buscar Design
✅ Listar Designs
✅ Tipos Suportados
📤 Exportações
🔄 Com este recurso, você conta com funcionalidades completas para exportar seus designs em diferentes formatos. Ele abrange desde a criação de jobs de exportação até o monitoramento do status de processamento, permitindo obter seus arquivos finalizados nos formatos PDF, PNG, JPG e MP4.
Lista de operações
✅ Criar Job de Exportação
✅ Verificar Status da Exportação
✅ Formatos PDF
✅ Formatos PNG/JPG
✅ Formatos MP4
📁 Pastas
🗂️ Este recurso disponibiliza ferramentas essenciais para organização e gerenciamento de pastas no Canva. Com ele, é possível criar novas pastas, organizar seus designs de forma estruturada e manter um workspace organizado para melhor produtividade.
Lista de operações
✅ Criar Pasta
✅ Listar Pastas
✅ Organizar Conteúdo
🖼️ Assets
📷 Com este recurso, você tem acesso ao gerenciamento de assets e elementos visuais no Canva. Ele permite buscar assets específicos, listar elementos disponíveis e gerenciar recursos visuais para seus projetos de forma eficiente.
Lista de operações
✅ Buscar Asset
✅ Listar Assets
✅ Gerenciar Recursos
👤 Usuários
🔐 Este recurso oferece funcionalidades para gerenciamento de informações de usuário e perfil. Com ele, é possível obter dados do usuário atual, verificar permissões e acessar informações de conta de forma segura.
Lista de operações
✅ Obter Perfil
✅ Verificar Permissões
✅ Informações da Conta
🔔 Webhooks
📡 Este recurso oferece funcionalidades completas para receber notificações em tempo real de eventos do Canva através de webhooks. Com ele, você pode monitorar criação de designs, atualizações, exportações concluídas e outros eventos importantes, permitindo automações instantâneas baseadas nas atividades da sua conta.
Lista de operações
✅ Design Criado
✅ Design Atualizado
✅ Exportação Concluída
✅ Asset Eventos
✅ Pasta Eventos
✅ Comentário Eventos
✅ Filtros Personalizados
🚀 Instalação
Via n8n Community Nodes:
- Abra sua instância do n8n
- Vá para Settings → Community Nodes
- Instale o pacote:
n8n-nodes-canva - Reinicie o n8n
Via NPM:
npm install n8n-nodes-canva
🔑 Configuração de Credenciais
Este node agora usa OAuth 2.0 nativo do n8n para autenticação automática:
-
Crie uma integração no Canva Developer Portal
- Faça login no Developer Portal
- Ative a MFA (Multi-Factor Authentication) se necessário
- Vá para "Your Integrations" e clique em "Create an integration"
- Escolha entre integração "Public" ou "Private"
-
Configure sua integração:
- Defina um nome para sua integração
- Copie o Client ID (será necessário no n8n)
- Gere e salve o Client Secret (será necessário no n8n)
- IMPORTANTE: Copie a URL de redirecionamento OAuth:
[YOUR-URL-BASE]/rest/oauth2-credential/callback
-
⚠️ CONFIGURAÇÃO CRÍTICA DE SCOPES:
ATENÇÃO: Para evitar o erro
"invalid_scope", você DEVE habilitar TODOS os scopes listados abaixo na seção Scopes da sua integração: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🚨 IMPORTANTE: Marque/habilite TODOS os 18 scopes acima na sua integração do Canva Developer Portal. Se qualquer scope estiver faltando, você receberá o erro
"invalid_scope"durante a autenticação OAuth. -
No n8n, crie uma nova credencial "Canva API":
- Client ID: Cole o Client ID obtido no Developer Portal
- Client Secret: Cole o Client Secret gerado no Developer Portal
- Clique em "Connect my account" para iniciar o fluxo OAuth
- Autorize a aplicação na tela do Canva
- ✅ Pronto! O n8n gerenciará automaticamente tokens e renovações
-
🎯 Vantagens do OAuth Nativo:
- ✅ Configuração simplificada – Apenas Client ID e Secret
- ✅ Renovação automática – n8n gerencia refresh tokens
- ✅ Segurança aprimorada – Sem tokens manuais expostos
- ✅ Fluxo padrão – Mesma experiência de outros nodes n8n
Migração: Se você usava versões anteriores com Access Token manual, delete a credencial antiga e crie uma nova seguindo os passos acima.
📡 Configuração de Webhooks
Para usar o Canva Trigger:
- Adicione o node Canva Trigger ao seu workflow
- Configure os eventos que deseja escutar
- Ative o workflow
- O webhook será automaticamente registrado no Canva
- Quando desativar o workflow, o webhook será removido automaticamente
🚨 Troubleshooting – Erro "invalid_scope"
Problema: Durante a autenticação OAuth, você recebe o erro:
Error: Insufficient parameters for OAuth2 callback.
Received following query parameters: {"error":"invalid_scope","error_description":"Requested scopes are not allowed for this client."}
Solução:
- Acesse sua integração no Canva Developer Portal
- Vá para a seção "Your integrations" > "Create an integration"
- Vá para a seção "Scopes" da sua integração
- Marque/habilite TODOS os 18 scopes listados na seção de configuração acima
- Salve as alterações
- Tente a conexão OAuth novamente no n8n
Causa: Este erro ocorre quando a aplicação OAuth2 no Canva não está configurada com todos os scopes que o n8n-nodes-canva precisa para funcionar corretamente.
🤝 Contribuição
Contribua para o crescimento deste projeto! Você pode ajudar de diversas formas:
- Pull Requests: Envie melhorias, correções ou novas funcionalidades.
- Issues: Relate problemas ou sugira novas ideias.
- Sugestões: Compartilhe suas opiniões e feedbacks.
- Documentação: Ajude a melhorar ou expandir a documentação existente.
Desenvolvido com ❤️ por Ramon Matias
