#native_company# #native_desc#

Integrate Mailchimp Newsletter Subscriptions with PHP

By Voja Janjic
on December 20, 2016

In this tutorial, we will discuss how to integrate one of the most popular mailing list services with PHP.


As most modern Web service providers do, MailChimp offers an SDK for their API. Let’s install it through Composer:

composer require drewm/mailchimp-api

After installing the library through Composer, instantiate the class:


use DrewMMailChimpMailChimp;
$mc = new MailChimp('api_key_goes_here'); 

$mc is the object which we will use to send requests to the API.

Subscribe Users

To subscribe a user to the list, we will need a form where users enter their e-mail address:

<form id="frm-newsletter" name="newsletter" method="post" action="subscribe.php">
	<input type="text" name="email" class="email" />

	<button type="submit" name="submit">Submit</button>

The form can be submitted using AJAX:

<script type="text/javascript">
	$('#frm-newsletter').submit(function(e) {
		  type: "POST",
		  url: 'subscribe.php',
		  dataType: 'json',
		  data: {
		  	email: $('#frm-newsletter .email').val(),
		  success: function(response) {
		  	// User has been successfully subscribed
			// Do something here
		  error: function (jqXHR, textStatus, errorThrown) {
var response = $.parseJSON(jqXHR.responseText);

// User has not been subscribed
// Show an error or do something else here	

		return false;

Subscribe.php validates the data, sends a request to MailChimp and returns the response:


$email = $_POST['email'];

$response = [];
$list_id = 'list_id_goes_here';

$resp = $mc->post("/lists/$list_id/members", [
    'email_address' => $email,
    'status' => 'subscribed'

if ($mc->success()) {
    $response['message'] = 'Thank you for subscribing to the mailing list';

    // User successfully subscribed - set HTTP status code to 200
} else {
    $response['message'] = $mc->getLastError();

    // User not subscribed - set HTTP status code to 400

// Return json-formatted response
echo json_encode($response); 

Depending on the HTTP status code of the response, it can be handled differently when the subscription is successful that when there is an error.

Unsubscribe Users

In order to unsubscribe a user, we need to fetch his subscriber hash first:

$subscriber_hash = $mc->subscriberHash('[email protected]'); 

Now that we have the hash, we can call the unsubscribe endpoint:

$list_id = 'list_id_goes_here';

Since users can unsubscribe through interfaces other than your application, it might be convenient to monitor those events. This can be achieved with Webhooks. Webhooks are configured through the MailChimp interface to send data to a specified URL whenever an event occurs. The URL that receives a Webhook request should have the following code:

use DrewMMailChimpWebhook;

Webhook::subscribe('unsubscribe', function($data){
    // User unsubscribed - do something here

The code from above will only handle “unsubscribe” events. If you would like to handle all Webhook events by yourself, do the following:


use DrewMMailChimpWebhook;

$result = Webhook::receive();


This tutorial has shown how to quickly create a form where users can sign up to your MailChimp newsletter list and how to unsubscribe them, if needed. However, MailChimp offers many more integration options, such as campaigns and reporting, as well as seamless integration with other services.