PHPackages                             ahsanrazib/laravel-mailchimp - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. ahsanrazib/laravel-mailchimp

ActiveLibrary[API Development](/categories/api)

ahsanrazib/laravel-mailchimp
============================

A Laravel wrapper for the Mailchimp API with support for lists, tags, unsubscribe, and campaign reports.

00PHP

Since Aug 2Pushed 9mo agoCompare

[ Source](https://github.com/ahsanrazib/laravel-mailchimp)[ Packagist](https://packagist.org/packages/ahsanrazib/laravel-mailchimp)[ RSS](/packages/ahsanrazib-laravel-mailchimp/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Laravel Mailchimp
=================

[](#laravel-mailchimp)

A simple Laravel 10–12+ compatible package to integrate with the Mailchimp API for email list management, tagging, unsubscribing, and campaign reporting.

✨ Features
----------

[](#-features)

- ✅ Connect to Mailchimp API
- 📥 Subscribe users to mailing lists
- 🏷️ Add tags to subscribers
- 🚫 Unsubscribe users
- 📊 Retrieve campaign reports
- 📄 Custom subscription form view
- 🔧 Laravel config publishing support

🛠 Requirements
--------------

[](#-requirements)

- PHP ^8.2
- Laravel ^10.0|^11.0|^12.0
- Guzzle 7+

🚀 Installation
--------------

[](#-installation)

### Step 1: Require the Package

[](#step-1-require-the-package)

```
composer require yourname/laravel-mailchimp
```

### Step 2: Publish the Config

[](#step-2-publish-the-config)

```
php artisan vendor:publish --provider="MailchimpSubscribe\MailchimpServiceProvider"
```

### Step 3: Set ENV Variables

[](#step-3-set-env-variables)

```
MAILCHIMP_API_KEY=your-mailchimp-api-key
MAILCHIMP_SERVER_PREFIX=usX
MAILCHIMP_LIST_ID=xxxxxxxxxx

```

📦 Usage
-------

[](#-usage)

### Subscribe a user

[](#subscribe-a-user)

```
use MailchimpSubscribe\Facades\MailchimpSubscribe;

MailchimpSubscribe::subscribe('user@example.com', ['FNAME' => 'John']);
```

### Add Tags

[](#add-tags)

```
MailchimpSubscribe::addTags('user@example.com', ['VIP', 'Newsletter']);
```

### Unsubscribe

[](#unsubscribe)

```
MailchimpSubscribe::unsubscribe('user@example.com');
```

### Get Lists

[](#get-lists)

```
$lists = MailchimpSubscribe::getLists();
```

### Get Campaign Reports

[](#get-campaign-reports)

```
$reports = MailchimpSubscribe::getCampaignReports();
$report = MailchimpSubscribe::getCampaignReportById('abc123');
```

📥 Subscription Form
-------------------

[](#-subscription-form)

Visit `/subscribe` for the basic subscription form included.

🔧 Configuration
---------------

[](#-configuration)

Config file: `config/mailchimp.php`
You can customize your API key, server prefix, and list ID here.

📂 File Structure
----------------

[](#-file-structure)

- `src/` - Service Provider, Manager, Facade
- `resources/views/` - Subscription Blade form
- `routes/web.php` - Form routes
- `config/mailchimp.php` - Config file

🤝 License
---------

[](#-license)

MIT © \[Ahsan Razib\]

###  Health Score

15

—

LowBetter than 3% of packages

Maintenance41

Moderate activity, may be stable

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity14

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/24feca6b57b36ea9a69f5dadf6f248b0df1ca50c5a5dcc23ccc524ed01c4e603?d=identicon)[ahsanrazib](/maintainers/ahsanrazib)

---

Top Contributors

[![sc-expert](https://avatars.githubusercontent.com/u/172747592?v=4)](https://github.com/sc-expert "sc-expert (2 commits)")

### Embed Badge

![Health badge](/badges/ahsanrazib-laravel-mailchimp/health.svg)

```
[![Health](https://phpackages.com/badges/ahsanrazib-laravel-mailchimp/health.svg)](https://phpackages.com/packages/ahsanrazib-laravel-mailchimp)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[knplabs/github-api

GitHub API v3 client

2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk

PHP SDK for Facebook Business

90121.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

73813.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

263103.1M454](/packages/google-gax)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)