progressivestudios/laravel-graph-mail

Microsoft Graph mail for Laravel: Create→Send, Sent/NDR tracking, throttling, subscriptions, REST APIs, RabbitMQ listener, templates, and a web UI.

v1.0.5 2025-11-17 16:04 UTC

Requires

• php: >=8.2
• guzzlehttp/guzzle: ^7.8
• illuminate/console: ^10.0|^11.0
• illuminate/events: ^10.0|^11.0
• illuminate/http: ^10.0|^11.0
• illuminate/queue: ^10.0|^11.0
• illuminate/support: ^10.0|^11.0
• php-amqplib/php-amqplib: ^3.5

Requires (Dev)

• mockery/mockery: ^1.6
• orchestra/testbench: ^8.0|^9.0
• pestphp/pest: ^2.0

MIT

• ProgressiveStudios

README

Send via Microsoft Graph REST APIs, RabbitMQ listener, templates, and a web UI.

Both modes can be enabled independently.

Install

composer require progressivestudios/laravel-graph-mail

php artisan vendor:publish --tag=graph-mail-config
php artisan vendor:publish --tag=graph-mail-migrations
php artisan vendor:publish --tag=graph-mail-views
php artisan vendor:publish --tag=graph-mail-assets

php artisan migrate

Configure .env with all required GRAPH_* and RabbitMQ settings.

Environment Configuration

Required .env

GRAPH_TENANT_ID=
GRAPH_CLIENT_ID=
GRAPH_CLIENT_SECRET=

GRAPH_SENDER=

GRAPH_BASE="https://graph.microsoft.com/v1.0"

GRAPH_SAVE_TO_SENT=true

GRAPH_MAIL_LOG_CHANNEL=graph-mail
GRAPH_API_PREFIX=graph-mail

REST Endpoints

• POST /api/{GRAPH_API_PREFIX}/messages
  Accepts:

  • html, or
  • template_key + data

• GET /api/{GRAPH_API_PREFIX}/messages/{id}
  Returns message status.

• GET /api/{GRAPH_API_PREFIX}/health
  Connectivity check.

RabbitMQ (Optional)

Enable:

GRAPH_RABBIT_ENABLED=true

Start consumer:

php artisan graph-mail:rabbit:consume

Messages published to RabbitMQ are handled by the same processing pipeline as REST and UI requests.

Templates

Templates may come from:

• DB (mail_templates)
• Blade views under resources/views/emails/*
• Custom mailable classes

Message creation supports:

• template_key
• data
• Optional subject override

Seeder example provided at database/seeders/MailTemplateSeeder.php.

Azure App Permissions (Application)

Required:

• Mail.Send

Admin consent is required.

Tooling Included

• OpenAPI spec: openapi.yaml
• Postman collection: postman.collection.json
• Docker compose (RabbitMQ): docker-compose.yml
• Template seeder: MailTemplateSeeder.php

Pro Version

A separate commercial package adds:

• Multi-tenant support
• Bulk sending
• Advanced routing
• Analytics & dashboards
• High-volume worker optimizations
• Sent/NDR tracking
• Throttling/backoff
• Webhook subscriptions

Available at:

progressivestudios/laravel-graph-mail-pro