PHPackages                             zfr/zfr-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. [Mail & Notifications](/categories/mail)
4. /
5. zfr/zfr-mailchimp

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

zfr/zfr-mailchimp
=================

PHP library for interacting with the v2 MailChimp REST API

v2.0.7(9y ago)44803.5k21[4 issues](https://github.com/zf-fr/zfr-mailchimp/issues)4MITPHPPHP >=5.3.3

Since Jul 17Pushed 9y ago8 watchersCompare

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

READMEChangelog (10)Dependencies (2)Versions (16)Used By (4)

ZfrMailChimp, a MailChimp PHP Library
=====================================

[](#zfrmailchimp-a-mailchimp-php-library)

[![Latest Stable Version](https://camo.githubusercontent.com/3db72683e51504a04a9b1ee05c2eae637c01d5500b6c48c7d84e8e211558698d/68747470733a2f2f706f7365722e707567782e6f72672f7a66722f7a66722d6d61696c6368696d702f762f737461626c652e706e67)](https://packagist.org/packages/zfr/zfr-mailchimp)

> IMPORTANT: MailChimp has announced the removal of old API (including v1 and v2) in their [blog post](http://devs.mailchimp.com/blog/sunsetting-previous-mailchimp-api-versions/). Because this library is based on v2, it will stop working at the end of the year. I don't have the time to update this library to the v3 as today, but if anyone would like to tackle it... do not hesitate!

> Note : this library does not contain tests, mainly because I'm not sure about how to write tests for an API wrapper. Don't hesitate to help on this ;-).

Introduction
------------

[](#introduction)

This is an unofficial MailChimp PHP client for interacting with the v2 REST MailChimp API. If you are looking for a wrapper around previous MailChimp API versions (like 1.3), please refer to something else.

What is done
------------

[](#what-is-done)

The following methods are supported by the client (not everything has been carefully tested though):

- Campaign related methods (complete)
- Ecomm related methods (complete)
- Vip related methods (complete)
- Folder related methods (complete)
- Users related methods (complete)
- Report related methods (only main methods)
- Templates related methods (complete)
- List related methods (nearly complete)
- Gallery related methods (complete)
- Helper related methods (partially complete)

Dependencies
------------

[](#dependencies)

- [Guzzle library](http://guzzlephp.org): >= 3.5

Integration with frameworks
---------------------------

[](#integration-with-frameworks)

To make this library even more easier to use, here are various frameworks integrations:

- [ZfrMailChimpModule](https://github.com/zf-fr/zfr-mailchimp-module): a Zend Framework 2 module
- [ZfrMailChimpBundle](https://github.com/zf-fr/zfr-mailchimp-bundle): a Symfony 2 bundle

Want to do an integration for another framework? Open an issue, and I'll open a repository for you!

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

[](#installation)

We recommend you to use Composer to install ZfrMailChimp:

```
php composer.phar require zfr/zfr-mailchimp:2.*
```

Tutorial
--------

[](#tutorial)

Firstly, you need to instantiate the MailChimp client:

```
$client = new MailChimpClient('my-api-key');
```

The correct endpoint will be automatically chosen based on your API key.

You can then have access to all the methods available (see the list below):

```
// Get activity about a list
$activity = $client->getListActivity(array(
    'id' => 'list-id'
));

// Add a new folder
$client->addFolder(array(
    'name' => 'my-folder-name',
    'type' => 'template'
));
```

### How to use it ?

[](#how-to-use-it-)

You will notice that the method names below does not always have a 1-to-1 mapping with the API names. For instance, most methods that imply retrieving something are prefixed by "get".

However, there is an exact mapping for parameters. Therefore, you just need to refer to the official documentation for a given method (links are given below). Here is an example with the [subscribe](http://apidocs.mailchimp.com/api/2.0/lists/subscribe.php) method:

```
$client->subscribe(array(
    'id' => 'list-id',
    'email' => array(
        'email' => 'example@foo.com',
        'euid'  => '1545d'
    )
));
```

### Exceptions handling

[](#exceptions-handling)

ZfrMailChimp tries its best to extract meaningful exceptions from MailChimp errors. All exceptions implement the `ZfrMailChimp\Exception\ExceptionInterface` interface, so you can use this to do a catch all block. You can find an exhaustive list of all exceptions in the `ZfrMailChimp\Exception` folder.

> List exceptions are under the Ls namespace, because list is a reserved keyword in PHP.

Usage example:

```
try {
    $client->subscribe(array(
        'id' => 'list-id',
        'email' => array(
            'email' => 'example@foo.com',
            'euid'  => '1545d'
        )
    ));
} catch (\ZfrMailChimp\Exception\Ls\AlreadySubscribedException $e) {
    $message = $e->getMessage();

    // You can do something interesting here!
} catch(\ZfrMailChimp\Exception\Ls\DoesNotExistException $e) {
    // Do something else useful!
}
catch (\ZfrMailChimp\Exception\ExceptionInterface $e) {
    // Any other exception that may occur
}
```

### Complete reference

[](#complete-reference)

Here are the supported methods today:

CAMPAIGN RELATED METHODS:

- array createCampaign(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/campaigns/create.php)
- array deleteCampaign(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/campaigns/delete.php)
- array getCampaignContent(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/campaigns/content.php)
- array getCampaigns(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/campaigns/list.php)
- array getTemplateContent(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/campaigns/template-content.php)
- array pauseCampaign(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/campaigns/pause.php)
- array replicateCampaign(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/campaigns/replicate.php)
- array resumeCampaign(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/campaigns/resume.php)
- array scheduleCampaign(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/campaigns/schedule.php)
- array scheduleBatchCampaign(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/campaigns/schedule-batch.php)
- array sendCampaign(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/campaigns/send.php)
- array sendTestCampaign(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/campaigns/send-test.php)
- array testSegmentation(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/campaigns/segment-test.php)
- array unscheduleCampaign(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/campaigns/unschedule.php)
- array updateCampaign(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/campaigns/update.php)

LIST RELATED METHODS:

- array addInterestGroup(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/interest-group-add.php)
- array addInterestGrouping(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/interest-grouping-add.php)
- array addListMergeVar(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/merge-var-add.php)
- array addListSegment(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/segment-add.php)
- array addListWebhook(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/webhook-add.php)
- array addStaticListSegment(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/static-segment-add.php)
- array addStaticSegmentMembers(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/static-segment-members-add.php)
- array batchSubscribe(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/batch-subscribe.php)
- array batchUnsubscribe(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/batch-unsubscribe.php)
- array deleteInterestGroup(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/interest-group-del.php)
- array deleteInterestGrouping(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/interest-grouping-del.php)
- array deleteListMergeVar(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/merge-var-del.php)
- array deleteListSegment(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/segment-del.php)
- array deleteListWebhook(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/webhook-del.php)
- array deleteStaticSegmentMembers(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/static-segment-members-del.php)
- array getAbuseReports(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/abuse-reports.php)
- array getInterestGroupings(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/interest-groupings.php)
- array getListActivity(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/activity.php)
- array getListClients(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/clients.php)
- array getListGrowthHistory(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/growth-history.php)
- array getListMergeVars(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/merge-vars.php)
- array getLists(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/list.php)
- array getListLocations(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/locations.php)
- array getListMembers(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/members.php)
- array getListMembersActivity(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/member-activity.php)
- array getListMembersInfo(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/member-info.php)
- array getListSegments(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/segments.php)
- array getListStaticSegments(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/static-segments.php)
- array getListWebhooks(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/webhooks.php)
- array resetListMergeVar(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/merge-var-reset.php)
- array resetStaticSegment(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/static-segment-reset.php)
- array setListMergeVar(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/merge-var-set.php)
- array subscribe(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/subscribe.php)
- array testListSegment(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/segment-test.php)
- array unsubscribe(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/unsubscribe.php)
- array updateInterestGroup(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/interest-group-update.php)
- array updateInterestGrouping(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/interest-grouping-update.php)
- array updateListMember(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/update-member.php)
- array updateListSegment(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/lists/segment-update.php)

ECOMM RELATED METHODS:

- array addOrder(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/ecomm/order-add.php)
- array deleteOrder(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/ecomm/order-del.php)
- array getOrders(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/ecomm/orders.php)

FOLDER RELATED METHODS:

- array addFolder(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/folders/add.php)
- array deleteFolder(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/folders/del.php)
- array getFolders(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/folders/list.php)
- array updateFolders(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/folders/update.php)

TEMPLATE RELATED METHODS:

- array addTemplate(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/templates/add.php)
- array deleteTemplate(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/templates/del.php)
- array getTemplateInfo(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/templates/info.php)
- array getTemplates(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/templates/list.php)
- array undeleteTemplate(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/templates/undel.php)
- array updateTemplate(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/templates/update.php)

REPORT RELATED METHODS:

- array getCampaignAbuseReport(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/reports/abuse.php)
- array getCampaignAdviceReport(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/reports/advice.php)
- array getCampaignBounceMessage(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/reports/bounce-message.php)
- array getCampaignBounceMessages(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/reports/bounce-messages.php)
- array getCampaignSummaryReport(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/reports/summary.php)
- array getCampaignGoogleAnalyticsReport(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/reports/google-analytics.php)

USERS RELATED METHODS:

- array inviteUser(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/users/invite.php)
- array getInvitations(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/users/invites.php)
- array getLogins(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/users/logins.php)
- array getProfile(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/users/profile.php)
- array reinviteUser(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/users/invite-resend.php)
- array revokeLogin(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/users/login-revoke.php)
- array revokeUserInvitation(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/users/invite-revoke.php)

VIP RELATED METHODS:

- array addVipMembers(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/vip/add.php)
- array deleteVipMembers(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/vip/del.php)
- array getVipMembers(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/vip/members.php)
- array getVipActivity(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/vip/activity.php)

GALLERY RELATED METHODS:

- array getGalleryImages(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/gallery/list.php)

HELPER RELATED METHODS:

- array getAccountDetails(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/helper/account-details.php)
- array ping(array $args = array()) [doc](http://apidocs.mailchimp.com/api/2.0/helper/ping.php)

Advanced usage
--------------

[](#advanced-usage)

### Attaching Guzzle plugins

[](#attaching-guzzle-plugins)

> UPDATE: Async plugin Guzzle 3 has been known to be very strange, and often not work as expected. Actually, it has even been removed in Guzzle 5. I'd suggest you to trying manually the Async plugin, but I recommend you NOT to use it.

Because ZfrMailChimp is built on top of Guzzle, you can take advantage of all the nice features of it. For instance, let's say you want to send requests asynchronously, you can simply attach the built-in Async plugin:

```
use ZfrMailChimp\Client\MailChimpClient;
use Guzzle\Plugin\Async\AsyncPlugin;

$client = new MailChimpClient('my-secret-key');
$client->addSubscriber(new AsyncPlugin());
$response = $client->get()->send();
```

###  Health Score

42

—

FairBetter than 90% of packages

Maintenance18

Infrequent updates — may be unmaintained

Popularity46

Moderate usage in the ecosystem

Community27

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 83.3% 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 ~94 days

Recently: every ~238 days

Total

14

Last Release

3455d ago

Major Versions

v1.2.0 → v2.0.02013-12-27

### Community

Maintainers

![](https://www.gravatar.com/avatar/9e3c74232d02a5fedbcef4650bac1d1103be292d4a013f6f9e692befcc9bb7ca?d=identicon)[bakura10](/maintainers/bakura10)

---

Top Contributors

[![bakura10](https://avatars.githubusercontent.com/u/1198915?v=4)](https://github.com/bakura10 "bakura10 (60 commits)")[![izotopSVK](https://avatars.githubusercontent.com/u/1786740?v=4)](https://github.com/izotopSVK "izotopSVK (3 commits)")[![univate](https://avatars.githubusercontent.com/u/122650?v=4)](https://github.com/univate "univate (3 commits)")[![lenada](https://avatars.githubusercontent.com/u/804642?v=4)](https://github.com/lenada "lenada (2 commits)")[![Manuel-Nieto](https://avatars.githubusercontent.com/u/13996449?v=4)](https://github.com/Manuel-Nieto "Manuel-Nieto (1 commits)")[![mickaelvieira](https://avatars.githubusercontent.com/u/3251585?v=4)](https://github.com/mickaelvieira "mickaelvieira (1 commits)")[![Ocramius](https://avatars.githubusercontent.com/u/154256?v=4)](https://github.com/Ocramius "Ocramius (1 commits)")[![krizon](https://avatars.githubusercontent.com/u/880695?v=4)](https://github.com/krizon "krizon (1 commits)")

---

Tags

mailmailchimpcampaign

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[zbateson/mail-mime-parser

MIME email message parser

53949.2M79](/packages/zbateson-mail-mime-parser)[thinkshout/mailchimp-api-php

PHP library for v3 of the MailChimp API

824.6M1](/packages/thinkshout-mailchimp-api-php)[zbateson/stream-decorators

PHP psr7 stream decorators for mime message part streams

4748.6M6](/packages/zbateson-stream-decorators)[opcodesio/mail-parser

Parse emails without the mailparse extension

216.8M8](/packages/opcodesio-mail-parser)[scullwm/mailhookbundle

A bundle to catch API webhook from differents mail service

4020.5k](/packages/scullwm-mailhookbundle)[hautzi/system-mail-bundle

This Bundle provides a nice abstraction for sending system emails

181.8k](/packages/hautzi-system-mail-bundle)

PHPackages © 2026

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