PHPackages                             rapidwebltd/simplemailchimp - 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. [Mail &amp; Notifications](/categories/mail)
4. /
5. rapidwebltd/simplemailchimp

ActiveLibrary[Mail &amp; Notifications](/categories/mail)

rapidwebltd/simplemailchimp
===========================

A simple MailChimp API wrapper, SimpleMailChimp makes it easy to pass data back and forth between your website and your MailChimp account. This includes subscribing or unsubscribing users, getting a subscriber’s details and getting all the members of a particular list.

v1.0.8(8y ago)091LGPL-3.0-onlyPHPPHP &gt;=5.3

Since Nov 2Pushed 8y ago5 watchersCompare

[ Source](https://github.com/rapidwebltd/SimpleMailChimp)[ Packagist](https://packagist.org/packages/rapidwebltd/simplemailchimp)[ RSS](/packages/rapidwebltd-simplemailchimp/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (9)Dependencies (1)Versions (10)Used By (0)

🐵 SimpleMailChimp
=================

[](#-simplemailchimp)

SimpleMailChimp is a simplified wrapper for common MailChimp functionality.

[![Simple MailChimp usage](assets/images/simple-mailchimp-usage.png)](assets/images/simple-mailchimp-usage.png)

Installation
------------

[](#installation)

To install this package, just use composer.

```
composer require rapidwebltd/simplemailchimp

```

If your framework does not already do so, you must add `require_once "vendor/autoload.php"` to any files in which you wish to use SimpleMailChimp.

Getting Started
---------------

[](#getting-started)

In order to create a `SimpleMailChimp` object, call the `getByAPIKey` function from the `SimpleMailChimpFactory` and pass it your API key.

```
$simpleMailChimp = SimpleMailChimpFactory::getByAPIKey('API_KEY_GOES_HERE');
```

### Subscribing a user to a list

[](#subscribing-a-user-to-a-list)

To subscribe a user to a list call the `subscribe` function and pass through the MailChimp list id and the user's email.

```
$simpleMailChimp->subscribe('LIST_ID_GOES_HERE', 'example@example.com');
```

If successful it will return an array containing the subscriber's data.

### Unsubscribing a user from a list

[](#unsubscribing-a-user-from-a-list)

To unsubscribe a user from a list call the `unsubscribe` function and pass through the MailChimp list id and the user's email.

```
$simpleMailChimp->unsubscribe('LIST_ID_GOES_HERE', 'example@example.com');
```

If successful it will return an array containing the subscriber's data.

### Getting a subscriber's details

[](#getting-a-subscribers-details)

To get the details of a specific subscriber from a list call the `getSubscriberDetails` function and pass through the MailChimp list id and the user's email.

```
$simpleMailChimp->getSubscriberDetails('LIST_ID_GOES_HERE', 'example@example.com');
```

If successful it will return an array containing the subscriber's data.

### Checking to see if a subscriber is already on a list and subscribed

[](#checking-to-see-if-a-subscriber-is-already-on-a-list-and-subscribed)

To see if a subscriber is already on a list and is subscribed call the `isSubscribedToList` function and pass through the MailChimp list id and the user's email.

```
$simpleMailChimp->isSubscribedToList('LIST_ID_GOES_HERE', 'example@example.com');
```

This function will return TRUE if the subscriber is found on the list AND is subscribed to it and return FALSE if either the user is not found on the list OR is in the list but set to unsubscribed.

### Getting all the members of a list

[](#getting-all-the-members-of-a-list)

To get all the members of a list call the `getAllUsersInList` function and pass through the MailChimp list id and a comma separated list of the specific fields you want to return. If no parameters are set it retrieves the member's email by default.

```
$simpleMailChimp->getAllUsersInList('LIST_ID_GOES_HERE');
```

Will return an array of emails belonging to members of the list specified.

```
$simpleMailChimp->getAllUsersInList('LIST_ID_GOES_HERE','email_address,status');
```

Will return an array of emails and the relevant statuses belonging to members of the list specified. Available parameters can be found on the MailChimp API documentation page (under 'Response body parameters' -&gt; 'members' -&gt; 'Show properties'): [http://developer.mailchimp.com/documentation/mailchimp/reference/lists/members/#read-get\_lists\_list\_id\_members](http://developer.mailchimp.com/documentation/mailchimp/reference/lists/members/#read-get_lists_list_id_members).

Note that this function returns all members of a list regardless of whether they are subscribed or not.

###  Health Score

29

—

LowBetter than 57% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 66.7% 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.

###  Release Activity

Cadence

Every ~56 days

Recently: every ~113 days

Total

9

Last Release

3067d ago

PHP version history (2 changes)v1.0PHP &gt;=5.6.0

v1.0.1PHP &gt;=5.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/c580cdf7c14898fff179cdfc1085892091d5d2f49d917873a12365af9ac77c93?d=identicon)[Jord-JD](/maintainers/Jord-JD)

---

Top Contributors

[![Jord-JD](https://avatars.githubusercontent.com/u/650645?v=4)](https://github.com/Jord-JD "Jord-JD (4 commits)")[![kirsty-gasston](https://avatars.githubusercontent.com/u/12949343?v=4)](https://github.com/kirsty-gasston "kirsty-gasston (2 commits)")

---

Tags

mailchimpmailchimp-apiphp-librarylibrarymailchimpPHP LibraryMailChimp libraryPHP MailChimp library

### Embed Badge

![Health badge](/badges/rapidwebltd-simplemailchimp/health.svg)

```
[![Health](https://phpackages.com/badges/rapidwebltd-simplemailchimp/health.svg)](https://phpackages.com/packages/rapidwebltd-simplemailchimp)
```

###  Alternatives

[spatie/laravel-newsletter

Manage Mailcoach, MailChimp and MailerLite newsletters in Laravel

1.6k6.5M27](/packages/spatie-laravel-newsletter)[thinkshout/mailchimp-api-php

PHP library for v3 of the MailChimp API

824.8M1](/packages/thinkshout-mailchimp-api-php)[statamic-rad-pack/mailchimp

Subscribe registrations or contact forms to Mailchimp

1821.0k](/packages/statamic-rad-pack-mailchimp)

PHPackages © 2026

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