PHPackages                             adrian7/mailchimp-api-v3 - 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. adrian7/mailchimp-api-v3

Abandoned → [https://github.com/mailchimp/mailchimp-marketing-php](/?search=https%3A%2F%2Fgithub.com%2Fmailchimp%2Fmailchimp-marketing-php)Library[API Development](/categories/api)

adrian7/mailchimp-api-v3
========================

Simple API wrapper for Mailchimp API version 3

v1.0.8(8y ago)0731MITPHPPHP &gt;=5.6.0

Since Jul 24Pushed 8y ago1 watchersCompare

[ Source](https://github.com/adrian7/mailchimp-api-v3)[ Packagist](https://packagist.org/packages/adrian7/mailchimp-api-v3)[ RSS](/packages/adrian7-mailchimp-api-v3/feed)WikiDiscussions master Synced 2w ago

READMEChangelog (2)Dependencies (2)Versions (11)Used By (1)

PHP Wrapper for MailChimp API v3 [![CircleCI](https://camo.githubusercontent.com/4e0914a2d846d98c9323cc810bf0b68a7026cff63b58caa0940e30f2b61b56da/68747470733a2f2f636972636c6563692e636f6d2f67682f61647269616e372f6d61696c6368696d702d6170692d76332f747265652f6d61737465722e7376673f7374796c653d737667)](https://circleci.com/gh/adrian7/mailchimp-api-v3/tree/master)
======================================================================================================================================================================================================================================================================================================================================================================

[](#php-wrapper-for-mailchimp-api-v3-)

- [Installation](#installation)
- [Usage](#usage)
    - [Pagination](#pagination)
    - [Filtering](#filtering)
    - [Partial Response](#partial-response)
    - [Behind Proxy](#behind-proxy)
- [Examples](#examples)
    - [Create lists](#create-lists)
    - [Subresources](#subresources)
    - [Proxy](#proxy)
- [Further documentation](#further-documentation)

Installation
============

[](#installation)

```
composer require adrian7/mailchimp-api-v3

```

Usage
=====

[](#usage)

There's one method to rule them all:

```
// $arguments is used as POST data or GET parameters, depending on the method used.
request($resource, $arguments = [], $method = 'GET')
```

But its clever enough to map these calls aswell:

```
get($resource, array $options = [])
head($resource, array $options = [])
put($resource, array $options = [])
post($resource, array $options = [])
patch($resource, array $options = [])
delete($resource, array $options = [])
```

### Pagination

[](#pagination)

*We use `offset` and `count` in the query string to paginate data, because it provides greater control over how you view your data. Offset defaults to 0, so if you use offset=1, you'll miss the first element in the dataset. Count defaults to 10.*

Source:

### Filtering

[](#filtering)

*Most endpoints don't currently support filtering, but we plan to add these capabilities over time. Schemas will tell you which collections can be filtered, and what to include in your query string.*

Source:

### Partial Response

[](#partial-response)

*To cut down on data transfers, pass a comma separated list of fields to include or exclude from a certain response in the query string. The parameters `fields` and `exclude_fields` are mutually exclusive and will throw an error if a field isn't valid in your request.*

Source:

### Behind Proxy

[](#behind-proxy)

If you are behind a proxy, you can use `setProxy` directly on the class.

`setProxy(host : string, port : int, [ssl : bool = false], [username = null], [password = null]);`

See the [example](#proxy).

Examples
========

[](#examples)

All queries will return an object containing the parsed json response.

```
$mc = new Mailchimp('', '');

// Get 10 lists starting from offset 10 and include only a specific set of fields
$result = $mc->request('lists', [
    'fields' => 'lists.id,lists.name,lists.stats.member_count',
    'offset' => 10,
    'count' => 10
]);

// Will fire this query:
// GET https://us1.api.mailchimp.com/3.0/lists?fields=lists.id,lists.name,lists.stats.member_count&count=10

var_dump($result);
```

### Create list

[](#create-list)

```
// All these fields are required to create a new list.
$result = $mc->post('lists', [
    'name' => 'New list',
    'permission_reminder' => 'You signed up for updates on mailchimp-api-v3.',
    'email_type_option' => false,
    'contact' => [
        'company' => 'Doe Ltd.',
		'address1' => 'DoeStreet 1',
		'address2' => '',
		'city' => 'Doesy',
		'state' => 'Doedoe',
		'zip' => '1672-12',
		'country' => 'US',
		'phone' => '55533344412'
    ],
    'campaign_defaults' => [
        'from_name' => 'John Doe',
        'from_email' => 'john@doe.com',
        'subject' => 'My new campaign!',
        'language' => 'US'
    ]
]);
```

### Subresources

[](#subresources)

```
$result = $mc->get('lists/e04d611199', [
    'fields' => 'id,name,stats.member_count'
]);
```

### Proxy

[](#proxy)

```
$mc->setProxy('https://127.0.0.1', 10, true, 'username', 'password');

$result = $mc->get('lists/e04d611199', [
    'fields' => 'id,name,stats.member_count'
]);
```

Further documentation
=====================

[](#further-documentation)

You should read through Mailchimp's API v3 [documentation](http://kb.mailchimp.com/api/).

###  Health Score

29

—

LowBetter than 57% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 59.6% 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 ~128 days

Recently: every ~162 days

Total

7

Last Release

3218d ago

PHP version history (2 changes)v1.0.2PHP &gt;=5.5.0

v1.0.7PHP &gt;=5.6.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/225180?v=4)[Adrian Şilimon-Morariu](/maintainers/adrian7)[@adrian7](https://github.com/adrian7)

---

Top Contributors

[![ChrisRM](https://avatars.githubusercontent.com/u/309292?v=4)](https://github.com/ChrisRM "ChrisRM (31 commits)")[![adrian7](https://avatars.githubusercontent.com/u/225180?v=4)](https://github.com/adrian7 "adrian7 (15 commits)")[![EricTendian](https://avatars.githubusercontent.com/u/498525?v=4)](https://github.com/EricTendian "EricTendian (2 commits)")[![jonathanwkelly](https://avatars.githubusercontent.com/u/453642?v=4)](https://github.com/jonathanwkelly "jonathanwkelly (2 commits)")[![dominicmartineau](https://avatars.githubusercontent.com/u/290412?v=4)](https://github.com/dominicmartineau "dominicmartineau (1 commits)")[![stefandoorn](https://avatars.githubusercontent.com/u/4903082?v=4)](https://github.com/stefandoorn "stefandoorn (1 commits)")

---

Tags

mailchimp-apimailchimp-api-v3mailchimp-api-wrapperphp-mailchimpphpapimailchimpv3

### Embed Badge

![Health badge](/badges/adrian7-mailchimp-api-v3/health.svg)

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

###  Alternatives

[theodo-group/llphant

LLPhant is a library to help you build Generative AI applications.

1.7k371.6k6](/packages/theodo-group-llphant)[hubspot/api-client

Hubspot API client

24015.5M18](/packages/hubspot-api-client)[pacely/mailchimp-apiv3

Simple API wrapper for Mailchimp API V3

95657.4k2](/packages/pacely-mailchimp-apiv3)[resend/resend-php

Resend PHP library.

596.2M35](/packages/resend-resend-php)[checkout/checkout-sdk-php

Checkout.com SDK for PHP

563.5M10](/packages/checkout-checkout-sdk-php)[mozex/anthropic-laravel

Laravel integration for the Anthropic API: facade, config publishing, install command, testing fakes, messages, streaming, tool use, thinking, and batches.

72287.1k1](/packages/mozex-anthropic-laravel)

PHPackages © 2026

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