How to use external HTML templates with scheduled Mailgun emails in Laravel

Other Questions Mailgun
1

I’m working on a Laravel project where I need to send delayed emails using Mailgun’s delivery time feature. Right now I can schedule emails just fine, but I’m running into issues with the HTML content.

Currently my code looks like this:

$mailgunClient->messages()->send($myDomain, [
    'from' => 'Support <[email protected]>',
    'to' => '[email protected]',
    'subject' => 'Welcome to our service',
    'html' => '<div><h1>Simple HTML here</h1></div>',
    'o:deliverytime' => Carbon::now()->addHours(3)->toRfc2822String()
]);

The issue is that when I try to add more complex HTML with lots of styling and content, putting it directly in the ‘html’ parameter makes the code messy and hard to read. I want to use a separate Blade template file instead.

Is there a way to reference an external HTML file or Blade template in the html parameter? Something like:

$mailgunClient->messages()->send($myDomain, [
    'from' => 'Support <[email protected]>',
    'to' => '[email protected]', 
    'subject' => 'Welcome to our service',
    'html' => 'emails.welcome-template',
    'o:deliverytime' => Carbon::now()->addHours(3)->toRfc2822String()
]);

How can I properly include external HTML templates when sending scheduled emails through Mailgun?

2

I like creating a dedicated helper method for this. Especially useful when you’ve got multiple email templates scattered around your app.

private function renderEmailTemplate($template, $data = [])
{
    return view($template, $data)->render();
}

// Then use it like:
$htmlContent = $this->renderEmailTemplate('emails.welcome-template', [
    'userName' => $user->name,
    'activationLink' => $activationUrl
]);

Keeps your Mailgun code cleaner and makes everything consistent. Also - test your HTML output in dev first. Debugging Blade issues after emails are already queued is a nightmare.

3

You need to render the Blade template to a string first before passing it to Mailgun. I’ve been using this for months with scheduled emails - works perfectly. Use Laravel’s view() helper with render() to compile your Blade template into HTML.

Here’s how I do it:

$htmlContent = view('emails.welcome-template', ['user' => $userData])->render();

$mailgunClient->messages()->send($myDomain, [
    'from' => 'Support <[email protected]>',
    'to' => '[email protected]',
    'subject' => 'Welcome to our service',
    'html' => $htmlContent,
    'o:deliverytime' => Carbon::now()->addHours(3)->toRfc2822String()
]);

The render() method processes all Blade syntax and spits out clean HTML for Mailgun. Pass variables to your template through view()'s second parameter. Way cleaner than inline HTML strings and keeps everything organized.

4

heads up - check your blade template for syntax errors before scheduling. learned this the hard way when my delayed emails went out with broken html lol. also, if you’re sending the same content to multiple people, cache the rendered template so you don’t re-render it every time