Weave Code
Laravel Sparkpost Driver Laravel Package
vemcogroup/laravel-sparkpost-driver
Laravel mail driver for SparkPost that sends transactional and bulk email through SparkPost's API using Laravel's native Mail facade. Configure your API key and sending domain, then send mail as usual. A simple drop-in alternative to SMTP for apps already using SparkPost.
SparkPost driver to use with Laravel
Frequently asked questions about Laravel Sparkpost Driver
- How do I install the SparkPost mail driver in a Laravel app?
- Run composer require vemcogroup/laravel-sparkpost-driver and let Laravel's package discovery register the service provider. Publish the package config if you want to adjust defaults, then add your SparkPost API key and sending domain to your .env file. Finally, point the mailer you want to use at the sparkpost driver in config/mail.php. After that you send mail through the normal Mail facade with no further code changes.
- Does this package support Laravel 13 and Laravel 12?
- The 5.2.0 release declares Laravel 13 support, but a one-line release note does not tell you whether the illuminate constraint was widened to ^12.0|^13.0 or replaced with ^13.0 only. Read the composer.json diff between tags before upgrading, because that single change decides whether the release is non-breaking for a Laravel 12 app. If support was replaced rather than widened, take the package upgrade together with your framework upgrade instead of ahead of it.
- How do I configure the SparkPost API key and sending domain?
- Keep the API key in your .env and reference it from config/services.php so it is never hardcoded in the repo. The sending domain is the SparkPost-verified domain your mail is sent from, and it must match a domain already configured in your SparkPost account. Once both are set, select the sparkpost mailer and send mail as usual through Laravel's Mail facade.
- Can I send bulk email with this driver, or only transactional mail?
- It sends through SparkPost's API, so both transactional and bulk mail go out through Laravel's normal Mail facade. Bulk sending still has to respect SparkPost's rate limits and reputation rules, so queue large batches rather than sending them inline during a request. Check your account's sending limits before any high-volume campaign.
- What is the difference between this driver and sending SparkPost mail over SMTP in Laravel?
- SMTP goes through SparkPost's SMTP relay using SMTP credentials, while this driver calls the SparkPost API directly with an API key. The API path avoids SMTP credential handling and typically surfaces more explicit API error responses than SMTP failures do. For simple setups either works fine, but the API driver is the better fit once delivery feedback and bulk volume matter.
- Is upgrading from 5.1 to 5.2.0 a breaking change?
- It is labelled a minor release, but it ships Laravel 13 support, which is exactly the kind of change that breaks things when the constraint is bumped rather than widened. Compare the illuminate/* and php constraints in composer.json between the two tags. Run composer why-not against your current lock file, update on a branch, and run the full suite before merging anything.
- What PHP version does this package require?
- Laravel 13 support usually comes with a raised minimum PHP version, so check the php constraint in the package's composer.json before upgrading. If the floor moved, your CI images and runtime base images have to be updated before composer install will even resolve. Treat the PHP requirement as part of the upgrade plan rather than an afterthought.
- How do I test the SparkPost driver without sending real email?
- Use Mail::fake() in your test suite so assertions run against the fake transport and no API calls go out. For an integration check, send a single message from a staging environment to a verified address and confirm it shows up in the SparkPost API logs. Keep real API keys out of test config and never point test suites at your production sending domain.
- What should I check before using this driver in production?
- Confirm your sending domain is verified in SparkPost and that the API key carries only the sending permissions it needs. Queue your mail so a slow or failed API call cannot block a request, and decide up front how failures should be retried. Also pin the package version and commit your lock file, since a floating constraint could pull in a future framework bump unintentionally.
- Is this package actively maintained, and what are the alternatives?
- The 5.2.0 release declaring Laravel 13 support is a liveness signal that the maintainer is tracking framework releases rather than letting the package go stale. Alternatives include sending SparkPost mail over SMTP, using SparkPost's own SDK inside a custom Laravel transport, or switching to another mail driver such as SES or Mailgun. Check the repository's release history and open issues before committing to it long term.
Weaver
How can I help you explore Laravel packages today?