> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lettr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Send transactional emails from Laravel with the official Lettr SDK, plugging into the Mail facade, Mailables, and notifications

Send transactional emails from your Laravel application using the official Lettr SDK. Get up and running in under a minute with our interactive setup command.

The `lettr/lettr-laravel` package provides a first-class Laravel integration that plugs directly into Laravel's mail system. Once installed, you can send emails through Lettr using the same `Mail` facade, Mailable classes, and notification channels you already know — no new abstractions to learn.

Using Cursor? [Jump straight in using this prompt](https://cursor.com/link/prompt?text=Help%20me%20add%20a%20Lettr%20sending%20example%20for%20Laravel%20using%20lettr%2Flettr-laravel%2C%20or%20migrate%20my%20current%20Laravel%20sending%20solution%20to%20Lettr%20using%20these%20docs%3A%20https%3A%2F%2Fdocs.lettr.com%2Fquickstart%2Flaravel%2Fintroduction)

## Why Use the Laravel SDK?

Rather than making raw API calls, the SDK gives you:

* **Native mail transport** — Lettr registers as a Laravel mailer, so `Mail::to()->send()` works out of the box
* **Template support** — Send Lettr-managed templates with merge tags directly from your application
* **Code generation** — Auto-generate enums, DTOs, and Mailable classes from your Lettr templates for compile-time safety
* **Zero lock-in** — Your Mailables remain standard Laravel classes. Switching away from Lettr only requires changing the mailer config

<Note>
  If you prefer not to use the SDK, you can also send emails via [SMTP](/quickstart/smtp/laravel) or the [REST API](/api-reference/emails/send-email) directly.
</Note>

## Prerequisites

Before you begin, make sure you have:

<CardGroup cols={2}>
  <Card title="API Key" icon="key" href="https://app.lettr.com/api-keys">
    Create an API key in the Lettr dashboard
  </Card>

  <Card title="Verified Domain" icon="globe" href="/learn/domains/sending-domains">
    Add and verify your sending domain
  </Card>
</CardGroup>

You'll also need:

* **PHP 8.4+** and **Composer** installed
* A **Laravel 10.x, 11.x, 12.x, or 13.x** application
* A `MAIL_FROM_ADDRESS` that uses your verified sending domain

## Quick Setup

The fastest way to get started is using our interactive init command. It configures everything automatically.

<Steps>
  <Step title="Install the package">
    ```bash theme={null}
    composer require lettr/lettr-laravel
    ```
  </Step>

  <Step title="Run the init command">
    ```bash theme={null}
    php artisan lettr:init
    ```
  </Step>

  <Step title="Send your first email">
    ```php theme={null}
    use App\Mail\WelcomeEmail;
    use Illuminate\Support\Facades\Mail;

    Mail::to('user@example.com')->send(new WelcomeEmail());
    ```

    Works with any Laravel Mailable - no code changes needed.
  </Step>
</Steps>

<Tip>
  If you already have Mailables in your application, they'll automatically route through Lettr once you set it as your default mailer. No refactoring required.
</Tip>

## The Init Command

The `lettr:init` command provides a guided setup experience that handles everything:

<Frame>
  <img src="https://mintcdn.com/lettr/6lblnm1oRyZWMHWl/images/lettr-init.gif?s=2d74a1d0cf606efc583311b6622c1a87" alt="lettr:init command demo" width="1320" height="1080" data-path="images/lettr-init.gif" />
</Frame>

**What it does:**

* Prompts for your API key and saves it to `.env`
* Publishes the configuration file
* Adds the Lettr mailer to `config/mail.php`
* Optionally sets Lettr as your default mailer
* Generates type-safe template enums and DTOs
* Configures your sending domain

No more manual config file editing or copy-pasting boilerplate.

<Info>
  Prefer manual control? The [Installation](/quickstart/laravel/installation) page walks through each step individually so you can configure exactly what you need.
</Info>

## Section Overview

This quickstart is organized into pages that build on each other:

| Page                                                 | What You'll Learn                                                                                     |
| ---------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| [Installation](/quickstart/laravel/installation)     | Manual setup, configuration options, and verifying your installation                                  |
| [Sending Emails](/quickstart/laravel/sending-emails) | All the ways to send emails — Mail facade, Lettr facade, builder, Mailables, attachments, and testing |
| [Templates](/quickstart/laravel/templates)           | Working with Lettr-managed templates, versioning, projects, and pulling/pushing templates locally     |
| [Type Safety](/quickstart/laravel/type-safety)       | Generating enums, DTOs, and Mailable classes for compile-time safety                                  |
| [Domains](/quickstart/laravel/domains)               | Add, verify, and manage sending domains                                                               |
| [Webhooks](/quickstart/laravel/webhooks)             | Create and manage webhook endpoints for delivery and engagement events                                |
| [Audience](/quickstart/laravel/audience)             | Manage lists, contacts, topics, properties, and segments                                              |
| [Campaigns](/quickstart/laravel/campaigns)           | List, inspect, send, and schedule campaigns                                                           |

## What's Next

<CardGroup cols={2}>
  <Card title="Installation" icon="download" href="/quickstart/laravel/installation">
    Manual installation and configuration options
  </Card>

  <Card title="Sending Emails" icon="paper-plane" href="/quickstart/laravel/sending-emails">
    Different ways to send emails
  </Card>

  <Card title="Templates" icon="file-code" href="/quickstart/laravel/templates">
    Use Lettr templates with merge tags
  </Card>

  <Card title="API Reference" icon="book" href="/api-reference/introduction">
    Complete API documentation
  </Card>

  <Card title="Integrations" icon="plug" href="/integrations/introduction">
    Stripe, Supabase, WordPress, and more
  </Card>
</CardGroup>