net3000.mailchimp 1.0.0

Net3000 MailChimp Library

A comprehensive C# library for integrating with the MailChimp API, designed specifically for Net3000 solutions.

Features

• Email List Management: Create, manage, and organize email lists
• Subscriber Management: Add, update, and remove subscribers from lists
• Campaign Management: Create and send email marketing campaigns
• Segmentation: Manage audience segments for targeted campaigns
• Async/Await Support: Modern asynchronous programming patterns
• Configuration Integration: Seamless integration with .NET configuration systems

Installation

Install via NuGet Package Manager:

Install-Package net3000.mailchimp

Or via .NET CLI:

dotnet add package net3000.mailchimp

Quick Start

Basic Setup

using Net3000.MailChimp.Services;

// Initialize with API key
var mailChimpService = new MailChimpService("your-mailchimp-api-key", "default-list-id");

// Or initialize with configuration
var mailChimpService = new MailChimpService(configuration);

Managing Lists

// Get all lists
var lists = await mailChimpService.GetListsAsync();

// Create a new list
var newList = new List
{
    Name = "My Newsletter",
    // ... other properties
};
var listId = await mailChimpService.CreateListAsync(newList);

Managing Subscribers

// Subscribe a single email
var result = await mailChimpService.SubscribeAsync("user@example.com", "John", "Doe", "list-id");

// Subscribe with merge fields
var mergeFields = new Dictionary<string, string>
{
    {"COMPANY", "Net3000"},
    {"CITY", "Toronto"}
};
await mailChimpService.SubscribeAsync("user@example.com", "John", "Doe", "list-id", mergeFields);

// Bulk subscribe
var emails = new List<string> { "user1@example.com", "user2@example.com" };
var results = await mailChimpService.AddNewMembersAsync("list-id", emails);

// Unsubscribe
await mailChimpService.UnsubscribeAsync("user@example.com", "list-id");

Campaign Management

// Create a campaign
var campaign = new Campaign
{
    // ... campaign properties
};
var campaignId = await mailChimpService.CreateCampaignAsync(campaign);

// Send campaign
await mailChimpService.SendCampaignAsync(campaignId);

Configuration

The library supports configuration through .NET's IConfiguration system:

{
  "MailChimp": {
    "ApiKey": "your-api-key",
    "DefaultListId": "your-default-list-id"
  }
}

Requirements

• .NET 9.0 or later
• MailChimp account and API key
• Valid MailChimp.Net.V3 package (automatically installed)

License

This library is licensed under the MIT License. See the LICENSE.md file for details.

Support

For support and questions:

• Visit: https://net3000.ca
• Email: support@net3000.ca

Contributing

This library is part of the Net3000 ecosystem and is primarily maintained for Net3000 applications.