|

|  How to Integrate Mailchimp Marketing API to Manage Audiences in Python

How to Integrate Mailchimp Marketing API to Manage Audiences in Python

October 31, 2024

Learn how to integrate Mailchimp Marketing API in Python to efficiently manage audiences. This guide covers step-by-step instructions for developers.

How to Integrate Mailchimp Marketing API to Manage Audiences in Python

 

Integrate Mailchimp Marketing API to Manage Audiences in Python

 

  • Firstly, ensure that you have the necessary API Key and List ID. These are crucial for authentication and requesting data.
  •  

  • Install the Mailchimp Marketing SDK for Python. You can do this using pip, which is the package installer for Python.

 

pip install mailchimp-marketing

 

  • Import and configure the Mailchimp client in your Python application. This setup includes setting your API key and server prefix (usually found at the end of your API key, after the hyphen).

 

from mailchimp_marketing import Client
from mailchimp_marketing.api_client import ApiClientError

mailchimp = Client()
mailchimp.set_config({
    "api_key": "YOUR_API_KEY",
    "server": "YOUR_SERVER_PREFIX"
})

 

  • Retrieve your current audience lists. With the Mailchimp client configured, you can fetch the existing audiences (called Lists in Mailchimp) to manage them further.

 

try:
    response = mailchimp.lists.all_lists()
    print(response)
except ApiClientError as error:
    print(f"An error occurred: {error.text}")

 

  • Add a new contact to a specific audience. Here, you need to provide the `List ID` and user data such as the email address for adding a contact.

 

list_id = "YOUR_LIST_ID"
member_info = {
    "email_address": "contact@example.com",
    "status": "subscribed",  # or 'pending' for double opt-in
    "merge_fields": {
        "FNAME": "First",
        "LNAME": "Last"
    }
}

try:
    response = mailchimp.lists.add_list_member(list_id, member_info)
    print("Contact added successfully:", response)
except ApiClientError as error:
    print(f"An error occurred: {error.text}")

 

  • Update subscriber information in your audience. To manage audiences effectively, updating contact information is essential. This requires specifying an MD5 hash of the lowercase version of the user's email address.

 

import hashlib

email_address = "contact@example.com"
subscriber_hash = hashlib.md5(email_address.lower().encode()).hexdigest()

update_info = {
    "merge_fields": {
        "FNAME": "Updated First Name",
        "LNAME": "Updated Last Name",
    }
}

try:
    response = mailchimp.lists.update_list_member(list_id, subscriber_hash, update_info)
    print("Contact updated successfully", response)
except ApiClientError as error:
    print(f"An error occurred: {error.text}")

 

  • Delete a contact from your audience. This involves using the MD5 hash again to identify the subscriber you wish to remove.

 

try:
    response = mailchimp.lists.delete_list_member(list_id, subscriber_hash)
    print("Contact deleted successfully")
except ApiClientError as error:
    print(f"An error occurred: {error.text}")

 

  • Consider handling errors appropriately. With network operations, errors are possible. Proper error handling ensures stability and provides clarity about issues that arise.

 

Remember, this setup provides a basic structure to manage audiences with the Mailchimp Marketing API. You can enhance it further by adding more features like batch operations, segment management, or even handling response pagination for large lists.

Pre-order Friend AI Necklace

Pre-Order Friend Dev Kit

Open-source AI wearable
Build using the power of recall

Order Now

OMI AI PLATFORM
Remember Every Moment,
Talk to AI and Get Feedback

Omi Necklace

The #1 Open Source AI necklace: Experiment with how you capture and manage conversations.

Build and test with your own Omi Dev Kit 2.

Omi App

Fully Open-Source AI wearable app: build and use reminders, meeting summaries, task suggestions and more. All in one simple app.

Github →

Join the #1 open-source AI wearable community

Build faster and better with 3900+ community members on Omi Discord

Participate in hackathons to expand the Omi platform and win prizes

Participate in hackathons to expand the Omi platform and win prizes

Get cash bounties, free Omi devices and priority access by taking part in community activities

Join our Discord → 

OMI NECKLACE + OMI APP
First & only open-source AI wearable platform

a person looks into the phone with an app for AI Necklace, looking at notes Friend AI Wearable recorded a person looks into the phone with an app for AI Necklace, looking at notes Friend AI Wearable recorded
a person looks into the phone with an app for AI Necklace, looking at notes Friend AI Wearable recorded a person looks into the phone with an app for AI Necklace, looking at notes Friend AI Wearable recorded
online meeting with AI Wearable, showcasing how it works and helps online meeting with AI Wearable, showcasing how it works and helps
online meeting with AI Wearable, showcasing how it works and helps online meeting with AI Wearable, showcasing how it works and helps
App for Friend AI Necklace, showing notes and topics AI Necklace recorded App for Friend AI Necklace, showing notes and topics AI Necklace recorded
App for Friend AI Necklace, showing notes and topics AI Necklace recorded App for Friend AI Necklace, showing notes and topics AI Necklace recorded

OMI NECKLACE: DEV KIT
Order your Omi Dev Kit 2 now and create your use cases

Omi Dev Kit 2

Endless customization

OMI Necklace

$69.99

Make your life more fun with your AI wearable clone. It gives you thoughts, personalized feedback and becomes your second brain to discuss your thoughts and feelings. Available on iOS and Android.

 

Your Omi will seamlessly sync with your existing omi persona, giving you a full clone of yourself – with limitless potential for use cases:

  • Real-time conversation transcription and processing;
  • Develop your own use cases for fun and productivity;
  • Hundreds of community apps to make use of your Omi Persona and conversations.

Learn more

Omi Dev Kit 2: build at a new level

Key Specs

OMI DEV KIT

OMI DEV KIT 2

Microphone

Yes

Yes

Battery

4 days (250mAH)

2 days (250mAH)

On-board memory (works without phone)

No

Yes

Speaker

No

Yes

Programmable button

No

Yes

Estimated Delivery 

-

1 week

What people say

“Helping with MEMORY,

COMMUNICATION

with business/life partner,

capturing IDEAS, and solving for

a hearing CHALLENGE."

Nathan Sudds

“I wish I had this device

last summer

to RECORD

A CONVERSATION."

Chris Y.

“Fixed my ADHD and

helped me stay

organized."

David Nigh

OMI NECKLACE: DEV KIT
Take your brain to the next level

LATEST NEWS
Follow and be first in the know

Latest news
FOLLOW AND BE FIRST IN THE KNOW

San Francisco

team@basedhardware.com
Title

Company

About

Careers

Invest
Title

Products

Omi Dev Kit 2

Openglass

Other

App marketplace

Affiliate

Privacy

Customizations

Discord

Docs

Help