jeffersongoncalves / laravel-mailchimp

1.0.0 2026-09-07 20:57 UTC

Requires

• php: ^8.2
• illuminate/http: ^12.0|^13.0
• illuminate/support: ^12.0|^13.0
• spatie/laravel-package-tools: ^1.16

Requires (Dev)

• larastan/larastan: ^3.0
• laravel/pint: ^1.21
• orchestra/testbench: ^10.0|^11.0
• pestphp/pest: ^3.0|^4.0
• pestphp/pest-plugin-laravel: ^3.0|^4.0

MIT

• Jefferson Gonçalves

• mailchimp
• api
• newsletter
• client
• email
• laravel
• marketing
• campaigns
• laravel-mailchimp
• jeffersongoncalves

Published on Packagist.org on 2026-09-07 20:57 UTC

README

Laravel Mailchimp

A Laravel wrapper for the Mailchimp Marketing API v3. Covers lists, members, campaigns, reports and automations through a simple, typed API built on Laravel's Http client.

Features

• Lists: list, get
• Members: list, add, update
• Campaigns: list, get, create, send
• Reports: get
• Automations: list
• Datacenter is derived automatically from the API key suffix (e.g. xxxx-us21 → us21)
• Throws MailchimpException (with the original API error body) on any non-2xx response

Installation

You can install the package via composer:

composer require jeffersongoncalves/laravel-mailchimp

Publish the config file:

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

Set your Mailchimp API key in .env:

MAILCHIMP_API_KEY=your-api-key-us21

Find (or generate) your API key under Account > Extras > API keys.

Configuration

// config/mailchimp.php
return [
    'api_key' => env('MAILCHIMP_API_KEY', ''),
];

Usage

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

Lists

use JeffersonGoncalves\Mailchimp\Facades\Mailchimp;

$lists = Mailchimp::lists()->list(count: 10, offset: 0);

$list = Mailchimp::lists()->get('abc123');

Members

$members = Mailchimp::members()->list('abc123', count: 10, offset: 0, status: 'subscribed');

Mailchimp::members()->add(
    listId: 'abc123',
    email: '[e-mail]',
    status: 'subscribed',
    firstName: 'Jane',
    lastName: 'Doe',
    tags: ['vip'],
);

Mailchimp::members()->update(
    listId: 'abc123',
    subscriberHash: md5(strtolower('[e-mail]')),
    status: 'unsubscribed',
);

Campaigns

$campaigns = Mailchimp::campaigns()->list(count: 10, offset: 0, status: 'sent', type: 'regular');

$campaign = Mailchimp::campaigns()->get('c1');

Mailchimp::campaigns()->create(
    listId: 'abc123',
    type: 'regular',
    subject: 'Hello!',
    fromName: 'Jane',
    replyTo: '[e-mail]',
    title: 'Welcome campaign',
);

Mailchimp::campaigns()->send('c1');

Reports

$report = Mailchimp::reports()->get('c1');

Automations

$automations = Mailchimp::automations()->list(count: 10, offset: 0);

Error handling

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

use JeffersonGoncalves\Mailchimp\Exceptions\MailchimpException;

try {
    Mailchimp::campaigns()->send('c1');
} catch (MailchimpException $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

• Jefferson Gonçalves
• All Contributors

License

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