nomadicsoft/laravel-dashamail

Laravel mail transport for DashaMail transactional API

dev-main 2026-04-06 07:43 UTC

Requires

• php: ^8.1
• illuminate/http: ^10.0|^11.0|^12.0
• illuminate/support: ^10.0|^11.0|^12.0
• symfony/mailer: ^6.0|^7.0

Requires (Dev)

• orchestra/testbench: ^8.0|^9.0|^10.0
• phpunit/phpunit: ^10.0|^11.0

MIT

• Nomadicsoft

• mail
• email
• russian
• laravel
• transport
• dashamail

README

Laravel mail transport for DashaMail — the leading Russian transactional and marketing email platform.

Built by Nomadicsoft.

Requirements

• PHP 8.1+
• Laravel 10, 11, or 12

Installation

composer require nomadicsoft/laravel-dashamail

The service provider is auto-discovered — no manual registration needed.

Prerequisites

Before sending, DashaMail requires:

1. Configured sending domain — add your domain with SPF & DKIM records at
   DashaMail dashboard → Аккаунт → Мои домены

2. Confirmed from-address — verify your sending address at
   Доставляемость → Подтверждённые отправители

3. API access enabled — on the free plan, email [e-mail] to enable the transactional API. On paid plans it is available immediately.

4. API key — find it at Интеграции → Транзакционные письма

Configuration

1. Add your API key to .env

DASHAMAIL_API_KEY=your_api_key_here
MAIL_MAILER=dashamail
MAIL_FROM_ADDRESS=[e-mail]
MAIL_FROM_NAME="Your App"

2. Add the mailer to config/mail.php

'mailers' => [

    'dashamail' => [
        'transport' => 'dashamail',
        'api_key'   => env('DASHAMAIL_API_KEY'),
    ],

    // ... other mailers
],

3. Set as default mailer

MAIL_MAILER=dashamail

Or use it explicitly per-send:

Mail::mailer('dashamail')->to($user)->send(new WelcomeMail());

Usage

Works with all standard Laravel mail features:

// Notifications
$user->notify(new ResetPasswordNotification($token));

// Mailables
Mail::to('[e-mail]')->send(new InvoiceMail($invoice));

// Fluent
Mail::mailer('dashamail')
    ->to('[e-mail]')
    ->cc('[e-mail]')
    ->send(new OrderConfirmationMail($order));

What's supported

Feature	Supported
HTML body	✅
Plain text body	✅
CC / BCC	✅
Reply-To	✅
Attachments	✅
Custom From name	✅
Transaction ID (message ID)	✅

Changelog

1.0.0

• Initial release

License

MIT. See LICENSE.

About Nomadicsoft

Nomadicsoft is a software development company. We build web applications, APIs, and internal tools.