Send with

Send email with Laravel

Laravel’s HTTP client makes the API a few lines of code. Render your content with Blade, and send from a queued job.

Configuration

# .env
ROBUSTEMAIL_API_KEY=rb_test_...
// config/services.php
'robustemail' => [
    'key' => env('ROBUSTEMAIL_API_KEY'),
    'url' => 'https://robustemail.com/api/v2',
],

A small service

<?php

namespace App\Services;

use Illuminate\Support\Facades\Http;

class RobustEmail
{
    public function send(array $email, ?string $idempotencyKey = null): string
    {
        $request = Http::withToken(config('services.robustemail.key'))
            ->acceptJson()
            ->timeout(15);

        if ($idempotencyKey) {
            $request = $request->withHeaders(['Idempotency-Key' => $idempotencyKey]);
        }

        return $request->post(config('services.robustemail.url') . '/emails', $email)
            ->throw()
            ->json('id');
    }
}

Send from a queued job

<?php

namespace App\Jobs;

use App\Models\Order;
use App\Services\RobustEmail;
use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Queue\SerializesModels;

class SendOrderConfirmation implements ShouldQueue
{
    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;

    public $tries = 5;
    public $backoff = [10, 30, 60, 120];

    public function __construct(public Order $order)
    {
    }

    public function handle(RobustEmail $mail): void
    {
        $mail->send([
            'from' => 'Acme <orders@acme.com>',
            'to' => $this->order->customer_email,
            'subject' => "Order #{$this->order->number} confirmed",
            'html' => view('emails.order-confirmed', ['order' => $this->order])->render(),
        ], "order-{$this->order->id}-confirmation");
    }
}

Because every retry of the job uses the same idempotency key, a job that timed out after the email was accepted never sends a second copy.

SendOrderConfirmation::dispatch($order);

Next