PHPackages shortinc/n8n-eloquent - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Database & ORM](/categories/database) 4. / 5. shortinc/n8n-eloquent ActiveLibrary[Database & ORM](/categories/database) shortinc/n8n-eloquent ===================== A Laravel package for seamlessly integrating Eloquent models with n8n workflows. Built with AI assistance using Cursor IDE. 2.1.3(8mo ago)061MITPHPPHP ^8.0 Since Aug 5Pushed 8mo agoCompare [ Source](https://github.com/Graffino/N8n-Eloquent)[ Packagist](https://packagist.org/packages/shortinc/n8n-eloquent)[ RSS](/packages/shortinc-n8n-eloquent/feed)WikiDiscussions develop Synced 1mo ago READMEChangelogDependencies (8)Versions (15)Used By (0) n8n-eloquent ============ [](#n8n-eloquent) [![n8n-eloquent Logo](docs/assets/logo.png)](docs/assets/logo.png)### Seamless Laravel Eloquent Integration for n8n [](#seamless-laravel-eloquent-integration-for-n8n) Build powerful workflows with your Laravel models [Features](#features) β€’ [Installation](#installation) β€’ [Quick Start](#quick-start) β€’ [Documentation](#documentation) β€’ [Roadmap](#roadmap) 🌟 Features ---------- [](#-features) ### Current Features [](#current-features) - πŸ”„ **Model Event Integration** - Automatic webhook registration for Eloquent models - Real-time model event broadcasting to n8n - Support for all model lifecycle events (create, update, delete, restore, saving, saved) - Targeted property change tracking with configurable field visibility - Automatic webhook lifecycle management with health monitoring - 🎯 **Job & Event System** - Dispatch Laravel jobs from n8n workflows with parameter validation - Listen for and dispatch custom Laravel events - Automatic job/event discovery and registration - Queue management with configurable options - Metadata tracking for workflow context - πŸ” **Enterprise-Grade Security** - Multi-layer security architecture with HMAC-SHA256 signature verification - API key authentication with timing-safe comparisons - IP whitelisting with CIDR support for webhook sources - Timestamp validation to prevent replay attacks ### Available Nodes [](#available-nodes) 1. **Laravel Eloquent Trigger Node** - Watch for model events (create, update, delete, restore, saving, saved) - Filter by specific model properties with advanced operators - Configure security settings (HMAC verification, IP filtering, timestamp validation) - Real-time event broadcasting with metadata tracking 2. **Laravel Event Listener Node** ⭐ **NEW** - Listen for custom Laravel events and trigger n8n workflows - Automatic event discovery and webhook registration - Full event payload serialization with metadata tracking - Loop prevention with n8n metadata detection - Security settings (HMAC verification, IP filtering, timestamp validation) 3. **Laravel Event Dispatcher Node** ⭐ **NEW** - Dispatch any Laravel event from n8n workflows - Automatic event discovery and parameter loading - Dynamic parameter validation and type checking - Metadata tracking for workflow context - Security-first approach with configurable options 4. **Laravel Eloquent CRUD Node** ⭐ **CONSOLIDATED** - **Unified Operations**: Create, read, update, and delete model records in a single node - **Advanced Filtering**: Multiple operators (equals, not equals, greater than, less than, like, in) - **Relationship Support**: Include related models with dynamic loading - **Pagination & Sorting**: Configurable limits, offsets, and order by clauses - **Batch Operations**: Support for multiple record operations - **Enhanced Error Handling**: Comprehensive validation and error categorization 5. **Laravel Job Dispatcher Node** ⭐ **ENHANCED** - Dispatch Laravel jobs from n8n workflows with full parameter validation - **Security-First Approach**: Only configured jobs are discoverable and dispatchable - **Multiple Dispatch Modes**: Immediate, delayed, and synchronous execution - **Queue Management**: Configurable queues, connections, and advanced options - **Automatic Parameter Discovery**: Dynamic loading of job constructor parameters - **Metadata Tracking**: Jobs include workflow and execution context information ### Advanced Capabilities [](#advanced-capabilities) - **πŸ”­ Laravel Telescope Integration**: Monitor all n8n-related activities with custom tagging - **Health Monitoring**: Automatic subscription recovery and health status tracking - **Comprehensive Logging**: Detailed audit trails with n8n-specific tags for easy filtering - **Error Recovery**: Robust error handling with automatic retry mechanisms - **Performance Optimization**: Efficient request handling with minimal overhead - **Scalability**: Designed for high-volume webhook processing with concurrent support ⚠️ Security Warning ------------------- [](#️-security-warning) **SSL Certificate Validation**: This package allows connecting to non-SSL certificated APIs (HTTP) by skipping all certificate validations for development and testing purposes. However, **we strongly recommend against using public non-HTTPS websites in production environments**. **Security Best Practices**: - Always use HTTPS in production environments - Ensure your Laravel application and n8n instance communicate over secure connections - Regularly update your SSL certificates - Consider using a reverse proxy (like nginx) with proper SSL termination - Monitor your webhook endpoints for any suspicious activity πŸ“¦ Installation -------------- [](#-installation) 1. Install via composer: ``` composer require shortinc/n8n-eloquent ``` 2. Install n8n nodes: ``` cd n8n-extension npm install npm run build ``` 3. Configure your `.env`: ``` N8N_WEBHOOK_URL=https://your-n8n-instance.com/webhook/path N8N_WEBHOOK_SECRET=your-secret-key ``` πŸš€ Quick Start ------------- [](#-quick-start) 1. Add the `HasWebhooks` trait to your model: ``` use Shortinc\N8nEloquent\Traits\HasWebhooks; class User extends Model { use HasWebhooks; protected static $webhookEvents = [ 'created', 'updated', 'deleted' ]; } ``` 2. Create a workflow in n8n: - Add the "Laravel Eloquent Trigger" node - Select your model and events - Connect to other nodes - Activate the workflow 3. Test the integration: ``` User::create(['name' => 'Test User']); // Will trigger n8n workflow ``` ### Event Listener Quick Start [](#event-listener-quick-start) 1. Create a custom Laravel event: ``` use Shortinc\N8nEloquent\Events\BaseEvent; class UserRegistered extends BaseEvent { public $user; public function __construct($user) { $this->user = $user; } } ``` 2. Create a workflow in n8n: - Add the "Laravel Event Listener" node - Select your custom event - Configure security settings - Connect to other nodes - Activate the workflow 3. Dispatch the event from Laravel: ``` event(new UserRegistered($user)); // Will trigger n8n workflow ``` ### Event Dispatcher Quick Start [](#event-dispatcher-quick-start) 1. Create a workflow in n8n: - Add the "Laravel Event Dispatcher" node - Select from available Laravel events - Configure event parameters - Connect to other nodes - Activate the workflow 2. Dispatch events from n8n workflows with full parameter validation and metadata tracking. ### Job Dispatcher Quick Start [](#job-dispatcher-quick-start) 1. Configure available jobs in `config/n8n-eloquent.php`: ``` 'jobs' => [ 'available' => [ 'App\\Jobs\\SendEmailJob', 'App\\Jobs\\ProcessDataJob', ], ], ``` 2. Create a workflow in n8n: - Add the "Laravel Job Dispatcher" node - Select from your configured jobs - Set parameters and queue options - Activate the workflow 3. Dispatch jobs from n8n workflows with full parameter validation and queue management. πŸ“š Documentation --------------- [](#-documentation) - [Complete Setup Guide](docs/setup.md) - [Node Documentation](docs/nodes.md) - [Security Guide](docs/security.md) - [Webhook Testing Guide](WEBHOOK_TESTING_GUIDE.md) - [API Reference](docs/api.md) - [Troubleshooting](docs/troubleshooting.md) πŸ—ΊοΈ Roadmap ---------- [](#️-roadmap) ### Future Plans (Q4 2025) [](#future-plans-q4-2025) 1. **Laravel Cache Node** - Cache operations with multiple store support - Atomic operations and cache tagging - Practical examples: API response caching, analytics storage, session management 2. **Laravel Queue Node** - Queue management and worker control - Failed job handling and retry mechanisms - Practical examples: job monitoring, queue optimization, workload distribution 3. **Laravel Notification Node** - Send Laravel notifications through multiple channels - Template system with dynamic content - Practical examples: multi-channel alerts, marketing communications, appointment reminders 4. **πŸ”­ Laravel Telescope Integration** - Advanced debugging and monitoring dashboard with n8n-specific panels - Real-time request tracking and performance profiling - Custom n8n tagging for easy log filtering and analysis - Detailed webhook and job execution monitoring - Automatic model discovery with dynamic field loading - Health monitoring with subscription recovery mechanisms - Integration with Laravel's error tracking and reporting ### Under Consideration [](#under-consideration) - **Laravel Broadcasting Node**: Real-time broadcasting for chat applications, live dashboards, and collaborative features - **Laravel File Storage Node**: File operations across different storage providers with backup and sharing capabilities - **Laravel Mail Node**: Email management with templates, queuing, and delivery tracking - **Laravel Schedule Node**: Task scheduling for backups, cleanup, and recurring operations - **Laravel Validation Node**: Data validation with custom rules and form validation logic 🀝 Contributing -------------- [](#-contributing) We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details. πŸ“œ License --------- [](#-license) The MIT License (MIT). Please see [License File](LICENSE) for more information. --- Built with ❀️ by Short Inc. Powered by n8n & Laravel ### Health Score 33 β€” LowBetter than 75% of packages Maintenance60 Regular maintenance activity Popularity6 Limited adoption so far Community9 Small or concentrated contributor base Maturity49 Maturing project, gaining track record Bus Factor1 Top contributor holds 55% of commits β€” single point of failure How is this calculated?**Maintenance (25%)** β€” Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** β€” Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** β€” Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** β€” Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~2 days Total 12 Last Release 257d ago Major Versions v1.0.7 β†’ 2.1.02025-08-25 ### Community Maintainers ![](https://www.gravatar.com/avatar/f9462bdaca0c5a5c44cdf23822f176555f46eceed1b0f70f518209c73e31a2fd?d=identicon)[shortdotinc](/maintainers/shortdotinc) --- Top Contributors [![nickciolpan](https://avatars.githubusercontent.com/u/8835763?v=4)](https://github.com/nickciolpan "nickciolpan (33 commits)")[![flcristian](https://avatars.githubusercontent.com/u/109615151?v=4)](https://github.com/flcristian "flcristian (27 commits)") --- Tags laravelautomationeloquentworkflowwebhooksn8nshortinc ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/shortinc-n8n-eloquent/health.svg) ``` [![Health](https://phpackages.com/badges/shortinc-n8n-eloquent/health.svg)](https://phpackages.com/packages/shortinc-n8n-eloquent) ``` ### Alternatives [mongodb/laravel-mongodb A MongoDB based Eloquent model and Query builder for Laravel 7.1k7.2M71](/packages/mongodb-laravel-mongodb)[watson/validating Eloquent model validating trait. 9723.3M47](/packages/watson-validating)[cybercog/laravel-ban Laravel Ban simplify blocking and banning Eloquent models. 1.1k651.8k11](/packages/cybercog-laravel-ban)[dyrynda/laravel-model-uuid This package allows you to easily work with UUIDs in your Laravel models. 4802.8M8](/packages/dyrynda-laravel-model-uuid)[roots/acorn Framework for Roots WordPress projects built with Laravel components. 9682.1M97](/packages/roots-acorn)[cybercog/laravel-love Make Laravel Eloquent models reactable with any type of emotions in a minutes! 1.2k302.7k1](/packages/cybercog-laravel-love) PHPackages Β© 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)