This is an n8n community node that provides seamless integration with the Tela API. It allows you to interact with Tela projects and canvases in your n8n workflows, enabling dynamic content generation and workflow automation.
Don't want to read? Import the sample workflow "Tela Canvas Execution with Dynamic Variables" to test this node with real Tela API integration.
The Tela node enables you to:
- Execute Tela Canvases: Run AI-powered canvases with dynamic variables and get results
- Dynamic Variable Handling: Automatically detect and configure canvas variables
- File Upload Support: Handle file uploads for canvas processing
- Project Management: List and manage Tela projects and their canvases
- Workflow Integration: Seamlessly integrate Tela AI workflows into your n8n automation
- Go to Settings > Community Nodes
- Select Install
- Enter
@meistrari/n8n-nodes-telaas the package name - Agree to the risks of using community nodes
- Select Install
For self-hosted n8n instances:
npm install @meistrari/n8n-nodes-telaFor Docker installations, follow the custom nodes guide.
- Create a new credential of type "Tela API"
- Enter your Tela API key (find this in your Tela dashboard)
- Test the connection to verify it works
- Project: Select the project containing your canvas
- Canvas: Choose the specific canvas to execute
- Variables: Configure dynamic fields based on your canvas configuration
The main operation that runs your Tela canvas with the specified variables and returns the AI-generated results.
Use Cases:
- Generate dynamic content for emails
- Create personalized marketing materials
- Process documents with AI assistance
- Generate reports based on input data
| Field | Description |
|---|---|
| API Key | Your Tela API key from your dashboard |
| Field | Type | Required | Description |
|---|---|---|---|
| Project | Options | Yes | Select the project containing your canvas |
| Canvas | Options | Yes | Select the canvas to execute |
| Variables | Collection | No | Dynamic fields based on your canvas configuration |
Input Data:
{
"customerName": "John Doe",
"productType": "Premium Subscription",
"monthlyAmount": 99.99
}Canvas Variables:
customer_name: John Doeproduct_type: Premium Subscriptionmonthly_amount: 99.99
Result: AI-generated personalized content based on your canvas configuration.
Input Data:
{
"document": "binary_file_data",
"processingType": "summarize"
}Canvas Variables:
document: [File upload]processing_type: summarize
Result: AI-processed document with summary or analysis.
Input Data:
{
"industry": "Technology",
"companySize": "100-500 employees",
"challenge": "Digital transformation"
}Canvas Variables:
industry: Technologycompany_size: 100-500 employeeschallenge: Digital transformation
Result: Tailored content addressing specific business challenges.
- Webhook receives new customer signup
- Tela generates personalized welcome email
- Send Email delivers the generated content
- File Upload receives document
- Tela processes and analyzes document
- Database stores processed results
- Notification sends completion alert
- CRM provides customer segments
- Tela generates personalized campaigns
- Marketing Platform deploys campaigns
- Analytics tracks performance
The node automatically detects canvas variables and their types:
- Text variables: Standard string inputs
- File variables: Automatic file upload handling
- Required fields: Clearly marked in the interface
- Supports multiple file formats
- Automatic MIME type detection
- Secure file upload to Tela servers
- Binary data processing from n8n workflows
- Projects: Dynamically loads available projects
- Canvases: Loads canvases based on selected project
- Variables: Auto-populates variable fields based on canvas
- n8n Version: 0.174.0 or later
- Node.js: 18.0.0 or later
- npm: 8.0.0 or later
- Platforms: n8n Cloud, Self-hosted instances
-
API Key Invalid
- Verify your Tela API key is correct
- Check if the key has expired
- Ensure proper permissions
-
Project Not Loading
- Verify API key has access to projects
- Check Tela API status
- Refresh credentials
-
Canvas Execution Fails
- Verify all required variables are set
- Check canvas configuration in Tela
- Review API response for error details
Failed to load projects: Check API key and permissionsFailed to load canvases: Verify project ID and accessFailed to execute canvas: Review variable configuration
- GitHub Issues: Report bugs and request features
- n8n Community: Ask questions in the community
- Documentation: Check the comprehensive docs
# Clone the repository
git clone https://github.com/meistrari/n8n-nodes-tela.git
cd n8n-nodes-tela
# Install dependencies
npm install
# Build the project
npm run build
# Link locally for testing
npm link# Run tests
npm test
# Build and test
npm run build && npm test- Added credential test method to fix n8n verification pre-checks
- Fixed n8n verification pre-checks by restructuring project to match n8n-nodes-starter template
- Moved credentials and nodes to proper directories as required by n8n
- Enhanced README documentation for n8n verification compliance
- Added comprehensive usage examples and sample workflows
- Improved installation and configuration instructions
- Added troubleshooting guide and development documentation
- Enhanced error handling
- Improved file upload support
- Better variable validation
- Initial release
- Basic Tela API integration
- Dynamic variable support