Download the PHP package nextmigrant/laravel-plunk without Composer
On this page you can find all versions of the php package nextmigrant/laravel-plunk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download nextmigrant/laravel-plunk
More information about nextmigrant/laravel-plunk
Files in nextmigrant/laravel-plunk
Package laravel-plunk
Short Description Integration for Plunk (useplunk.com)
License MIT
Homepage https://github.com/nextmigrant/laravel-plunk
Informations about the package laravel-plunk
Laravel Plunk
A clean, expressive Laravel package for the Plunk email platform. Send transactional emails, manage contacts, track events, and verify email addresses — all through a simple Facade.
Works with Plunk SaaS and self-hosted instances.
Features
- 📧 Transactional Emails — Send with templates, attachments, custom headers, and reply-to
- 👥 Contact Management — Full CRUD with bulk ops, CSV import, and cursor pagination
- 📝 Template Management — Full CRUD with duplicate and usage tracking
- 📣 Campaign Management — Create, send, schedule, cancel, and track stats
- 🎯 Segment Management — Dynamic/static segments with member management
- 📡 Event Tracking — Track events with automatic contact upsert and workflow triggers
- ✅ Email Verification — Validate format, MX records, disposable domains, and typos
- 🔑 Dual Key Support — Secret key for admin APIs, public key for event tracking
- 🛡️ Typed Exceptions —
AuthenticationException,ValidationException,RateLimitException,BillingException,ConflictException - ⚡ Built on Laravel HTTP Client — Retries, timeouts, and
Http::fake()for testing
Requirements
- PHP 8.3+
- Laravel 11, 12, or 13
Installation
Publish the config file:
Add your configuration to .env:
Quick Start
Usage
Transactional Emails
Send with inline content or a template. Requires either template, or both subject and body:
Event Tracking
Track events to trigger Plunk workflows. Contacts are created automatically if they don't exist:
Note: The
/v1/trackendpoint requires a public key (pk_*). Secret keys are not accepted for this endpoint. SetPLUNK_PUBLIC_KEYin your.env.
Contact Management
Basic CRUD
Bulk Operations
All bulk operations are async and return a jobId for status polling:
Templates
Campaigns
Segments
Email Verification
Configuration
The published config file (config/plunk.php):
Error Handling
The package throws typed exceptions mapped from HTTP status codes. All exceptions expose errorCode, requestId, and suggestion from the Plunk error response:
Testing
The package uses Laravel's HTTP client under the hood, so you can use Http::fake() in your application tests:
Run the package test suite:
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
- NextMigrant
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
All versions of laravel-plunk with dependencies
spatie/laravel-package-tools Version ^1.16
illuminate/contracts Version ^11.0||^12.0||^13.0