README

Laravel Resend

A Laravel wrapper for the Resend API. Covers emails, domains, API keys, audiences, contacts, webhooks, templates, broadcasts and segments through a simple, typed API built on Laravel's Http client.

Features

Emails: send, batch, list, get, cancel
Domains: list, get, create, verify, delete
API keys: list, create, delete
Audiences: list, get, create, delete
Contacts: list, get, create, update, delete
Webhooks: list, get, create, delete
Templates: list, get, create, update, delete, publish, duplicate
Broadcasts: list, get, create, send, delete
Segments: list, get, create, delete
Throws ResendException (with the original API error body) on any non-2xx response

Installation

You can install the package via composer:

composer require jeffersongoncalves/laravel-resend

Publish the config file:

php artisan vendor:publish --tag=resend-config

Set your Resend API key in .env:

RESEND_API_KEY=re_your_api_key

Create (or find) your API key at resend.com/api-keys.

Configuration

// config/resend.php
return [
    'api_key' => env('RESEND_API_KEY', ''),
    'base_url' => env('RESEND_BASE_URL', 'https://api.resend.com'),
];

Usage

The package is resolved via the Resend facade or by injecting JeffersonGoncalves\Resend\Resend. Each resource is exposed as a method returning a dedicated resource class.

Emails

use JeffersonGoncalves\Resend\Facades\Resend;

Resend::emails()->send([
    'from' => 'Acme <hello@example.com>',
    'to' => ['jane@example.com'],
    'subject' => 'Hello!',
    'html' => '<p>Welcome aboard.</p>',
]);

Resend::emails()->batch([
    ['from' => 'hello@example.com', 'to' => ['a@example.com'], 'subject' => 'A', 'html' => '<p>A</p>'],
    ['from' => 'hello@example.com', 'to' => ['b@example.com'], 'subject' => 'B', 'html' => '<p>B</p>'],
]);

$emails = Resend::emails()->list(limit: 10);

$email = Resend::emails()->get('email_id');

Resend::emails()->cancel('email_id');

Domains

$domains = Resend::domains()->list(limit: 10);

$domain = Resend::domains()->get('domain_id');

Resend::domains()->create('example.com', region: 'us-east-1');

Resend::domains()->verify('domain_id');

Resend::domains()->delete('domain_id');

API keys

$keys = Resend::apiKeys()->list();

Resend::apiKeys()->create('production', permission: 'sending_access', domainId: 'domain_id');

Resend::apiKeys()->delete('api_key_id');

Audiences and contacts

$audiences = Resend::audiences()->list();

Resend::audiences()->create('Newsletter');

Resend::contacts()->create(
    audienceId: 'audience_id',
    email: 'jane@example.com',
    firstName: 'Jane',
    lastName: 'Doe',
);

Resend::contacts()->update(
    audienceId: 'audience_id',
    contactId: 'contact_id',
    unsubscribed: true,
);

Resend::contacts()->delete('audience_id', 'contact_id');

Webhooks

Resend::webhooks()->create('https://example.com/webhooks/resend', [
    'email.sent',
    'email.delivered',
    'email.bounced',
]);

$webhooks = Resend::webhooks()->list();

Resend::webhooks()->delete('webhook_id');

Templates

Resend::templates()->create('Welcome', '<p>Hi {{name}}</p>', [
    'subject' => 'Welcome aboard',
    'from' => 'hello@example.com',
]);

Resend::templates()->update('template_id', ['subject' => 'New subject']);

Resend::templates()->publish('template_id');

Resend::templates()->duplicate('template_id');

Broadcasts and segments

Resend::segments()->create('Active subscribers');

$broadcast = Resend::broadcasts()->create(
    segmentId: 'segment_id',
    from: 'hello@example.com',
    subject: 'Release notes',
    attributes: ['html' => '<p>What is new.</p>'],
);

Resend::broadcasts()->send($broadcast['id'], scheduledAt: '2026-01-01T10:00:00Z');

Error handling

Any non-2xx API response throws JeffersonGoncalves\Resend\Exceptions\ResendException, which exposes the decoded error body:

use JeffersonGoncalves\Resend\Exceptions\ResendException;

try {
    Resend::emails()->send($payload);
} catch (ResendException $e) {
    logger()->error($e->getMessage(), $e->errorBody());
}

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

License

The MIT License (MIT). Please see License File for more information.

jeffersongoncalves / laravel-resend

Package info

Security

Statistics