MailChimp.Net.V3 4.2.0

A .NET Wrapper for Mail Chimp v3.0 API

There is a newer version of this package available.
See the version list below for details.
Install-Package MailChimp.Net.V3 -Version 4.2.0
dotnet add package MailChimp.Net.V3 --version 4.2.0
<PackageReference Include="MailChimp.Net.V3" Version="4.2.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add MailChimp.Net.V3 --version 4.2.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

MailChimp.Net - A Mail Chimp 3.0 Wrapper

Backers on Open Collective
Sponsors on Open Collective

License

MailChimp.Net is licensed under the MIT license.

Quick Start

Install the NuGet package from the package manager console:

Install-Package MailChimp.Net.V3

Using it in code

IMailChimpManager manager = new MailChimpManager(apiKey); //if you have it in code

<add key="MailChimpApiKey" value="apiKEY" />
IMailChimpManager manager = new MailChimpManager(); //if you have it in config

Examples

// Instantiate new manager
IMailChimpManager mailChimpManager = new MailChimpManager(apiKey);
Getting all lists:
var mailChimpListCollection = await this.mailChimpManager.Lists.GetAllAsync().ConfigureAwait(false);
Getting 50 Lists:
var mailChimpListCollection = await this.mailChimpManager.Lists.GetAllAsync(new ListRequest
                                                               {
                                                                   Limit = 50
                                                               }).ConfigureAwait(false);
Getting Users from List:
var listId = "TestListId";
await this.mailChimpManager.Members.GetAllAsync(listId).ConfigureAwait(false);
Adding New User To List
var listId = "TestListId";
// Use the Status property if updating an existing member
var member = new Member { EmailAddress = $"githubTestAccount@test.com", StatusIfNew = Status.Subscribed };
member.MergeFields.Add("FNAME", "HOLY");
member.MergeFields.Add("LNAME", "COW");
await this.mailChimpManager.Members.AddOrUpdateAsync(listId, member);
Updating An Existing User
// Get reference to existing user if you don't already have it
var listId = "TestListId";
var members = await this.mailChimpManager.Members.GetAllAsync(listId).ConfigureAwait(false);
var member = members.First(x => x.EmailAddress == "abc@def.com");

// Update the user
member.MergeFields.Add("FNAME", "New first name");
member.MergeFields.Add("LNAME", "New last name");
await this.mailChimpManager.Members.AddOrUpdateAsync(listId, member);
Adding/Removing a Tag From a User
Tags tags = new Tags();
tags.MemberTags.Add(new Tag() { Name = "Awesome Person", Status = "active" });
await this.mailChimpManager.Members.AddTagsAsync(listId, "abc@def.com", tags);

To remove the tag, use "inactive" as the Status.

Status

Progress on full implementation

  • API 100%
  • Authorized Apps 100%
  • Automations 100%
  • Batch Operations 100%
  • Campaigns 100%
  • Campaign Content 100%
  • Campaing Feedback 100%
  • Campaign Folders 100%
  • Campaing Send Checklist 100%
  • Conversations 100%
  • Conversations Messages 100%
  • ECommerce Stores 100%
  • File Manager Files 100%
  • File Manager Folders 100%
  • Lists 100%
  • List Abuse Reports 100%
  • List Activity 100%
  • List Clients 100%
  • List Growth History 100%
  • List Interest Categories 100%
  • List Members 100%
  • List Segments 100%
  • List Web Hooks 100%
  • Template Folders 100%
  • Templates 100%
  • Template Default Content 100%
  • Reports 100%
  • Report Click Reports 100%
  • Report Domain Performance 100%
  • Report EepURL Reports 100%
  • Report Email Activity 100%
  • Report Location 100%
  • Report Sent To 100%
  • Report Sub-Reports 100%
  • Report Unsubscribes 100%
  • ECommerce Carts 100%
  • ECommerce Customers 100%
  • ECommerce Orders 100%
  • ECommerce Order Lines 100%
  • ECommerce Products 100%
  • ECommerce Product Variants 100%

Total 100%

Contributors

This project exists thanks to all the people who contribute. [Contribute].
<a href="https://github.com/brandonseydel/MailChimp.Net/graphs/contributors"><img src="https://opencollective.com/mailchimp/contributors.svg?width=890&button=false" /></a>

Backers

Thank you to all our backers! 🙏 [Become a backer]

<a href="https://opencollective.com/mailchimp#backers" target="_blank"><img src="https://opencollective.com/mailchimp/backers.svg?width=890"></a>

Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [Become a sponsor]

<a href="https://opencollective.com/mailchimp/sponsor/0/website" target="_blank"><img src="https://opencollective.com/mailchimp/sponsor/0/avatar.svg"></a>
<a href="https://opencollective.com/mailchimp/sponsor/1/website" target="_blank"><img src="https://opencollective.com/mailchimp/sponsor/1/avatar.svg"></a>
<a href="https://opencollective.com/mailchimp/sponsor/2/website" target="_blank"><img src="https://opencollective.com/mailchimp/sponsor/2/avatar.svg"></a>
<a href="https://opencollective.com/mailchimp/sponsor/3/website" target="_blank"><img src="https://opencollective.com/mailchimp/sponsor/3/avatar.svg"></a>
<a href="https://opencollective.com/mailchimp/sponsor/4/website" target="_blank"><img src="https://opencollective.com/mailchimp/sponsor/4/avatar.svg"></a>
<a href="https://opencollective.com/mailchimp/sponsor/5/website" target="_blank"><img src="https://opencollective.com/mailchimp/sponsor/5/avatar.svg"></a>
<a href="https://opencollective.com/mailchimp/sponsor/6/website" target="_blank"><img src="https://opencollective.com/mailchimp/sponsor/6/avatar.svg"></a>
<a href="https://opencollective.com/mailchimp/sponsor/7/website" target="_blank"><img src="https://opencollective.com/mailchimp/sponsor/7/avatar.svg"></a>
<a href="https://opencollective.com/mailchimp/sponsor/8/website" target="_blank"><img src="https://opencollective.com/mailchimp/sponsor/8/avatar.svg"></a>
<a href="https://opencollective.com/mailchimp/sponsor/9/website" target="_blank"><img src="https://opencollective.com/mailchimp/sponsor/9/avatar.svg"></a>

MailChimp.Net - A Mail Chimp 3.0 Wrapper

Backers on Open Collective
Sponsors on Open Collective

License

MailChimp.Net is licensed under the MIT license.

Quick Start

Install the NuGet package from the package manager console:

Install-Package MailChimp.Net.V3

Using it in code

IMailChimpManager manager = new MailChimpManager(apiKey); //if you have it in code

<add key="MailChimpApiKey" value="apiKEY" />
IMailChimpManager manager = new MailChimpManager(); //if you have it in config

Examples

// Instantiate new manager
IMailChimpManager mailChimpManager = new MailChimpManager(apiKey);
Getting all lists:
var mailChimpListCollection = await this.mailChimpManager.Lists.GetAllAsync().ConfigureAwait(false);
Getting 50 Lists:
var mailChimpListCollection = await this.mailChimpManager.Lists.GetAllAsync(new ListRequest
                                                               {
                                                                   Limit = 50
                                                               }).ConfigureAwait(false);
Getting Users from List:
var listId = "TestListId";
await this.mailChimpManager.Members.GetAllAsync(listId).ConfigureAwait(false);
Adding New User To List
var listId = "TestListId";
// Use the Status property if updating an existing member
var member = new Member { EmailAddress = $"githubTestAccount@test.com", StatusIfNew = Status.Subscribed };
member.MergeFields.Add("FNAME", "HOLY");
member.MergeFields.Add("LNAME", "COW");
await this.mailChimpManager.Members.AddOrUpdateAsync(listId, member);
Updating An Existing User
// Get reference to existing user if you don't already have it
var listId = "TestListId";
var members = await this.mailChimpManager.Members.GetAllAsync(listId).ConfigureAwait(false);
var member = members.First(x => x.EmailAddress == "abc@def.com");

// Update the user
member.MergeFields.Add("FNAME", "New first name");
member.MergeFields.Add("LNAME", "New last name");
await this.mailChimpManager.Members.AddOrUpdateAsync(listId, member);
Adding/Removing a Tag From a User
Tags tags = new Tags();
tags.MemberTags.Add(new Tag() { Name = "Awesome Person", Status = "active" });
await this.mailChimpManager.Members.AddTagsAsync(listId, "abc@def.com", tags);

To remove the tag, use "inactive" as the Status.

Status

Progress on full implementation

  • API 100%
  • Authorized Apps 100%
  • Automations 100%
  • Batch Operations 100%
  • Campaigns 100%
  • Campaign Content 100%
  • Campaing Feedback 100%
  • Campaign Folders 100%
  • Campaing Send Checklist 100%
  • Conversations 100%
  • Conversations Messages 100%
  • ECommerce Stores 100%
  • File Manager Files 100%
  • File Manager Folders 100%
  • Lists 100%
  • List Abuse Reports 100%
  • List Activity 100%
  • List Clients 100%
  • List Growth History 100%
  • List Interest Categories 100%
  • List Members 100%
  • List Segments 100%
  • List Web Hooks 100%
  • Template Folders 100%
  • Templates 100%
  • Template Default Content 100%
  • Reports 100%
  • Report Click Reports 100%
  • Report Domain Performance 100%
  • Report EepURL Reports 100%
  • Report Email Activity 100%
  • Report Location 100%
  • Report Sent To 100%
  • Report Sub-Reports 100%
  • Report Unsubscribes 100%
  • ECommerce Carts 100%
  • ECommerce Customers 100%
  • ECommerce Orders 100%
  • ECommerce Order Lines 100%
  • ECommerce Products 100%
  • ECommerce Product Variants 100%

Total 100%

Contributors

This project exists thanks to all the people who contribute. [Contribute].
<a href="https://github.com/brandonseydel/MailChimp.Net/graphs/contributors"><img src="https://opencollective.com/mailchimp/contributors.svg?width=890&button=false" /></a>

Backers

Thank you to all our backers! 🙏 [Become a backer]

<a href="https://opencollective.com/mailchimp#backers" target="_blank"><img src="https://opencollective.com/mailchimp/backers.svg?width=890"></a>

Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [Become a sponsor]

<a href="https://opencollective.com/mailchimp/sponsor/0/website" target="_blank"><img src="https://opencollective.com/mailchimp/sponsor/0/avatar.svg"></a>
<a href="https://opencollective.com/mailchimp/sponsor/1/website" target="_blank"><img src="https://opencollective.com/mailchimp/sponsor/1/avatar.svg"></a>
<a href="https://opencollective.com/mailchimp/sponsor/2/website" target="_blank"><img src="https://opencollective.com/mailchimp/sponsor/2/avatar.svg"></a>
<a href="https://opencollective.com/mailchimp/sponsor/3/website" target="_blank"><img src="https://opencollective.com/mailchimp/sponsor/3/avatar.svg"></a>
<a href="https://opencollective.com/mailchimp/sponsor/4/website" target="_blank"><img src="https://opencollective.com/mailchimp/sponsor/4/avatar.svg"></a>
<a href="https://opencollective.com/mailchimp/sponsor/5/website" target="_blank"><img src="https://opencollective.com/mailchimp/sponsor/5/avatar.svg"></a>
<a href="https://opencollective.com/mailchimp/sponsor/6/website" target="_blank"><img src="https://opencollective.com/mailchimp/sponsor/6/avatar.svg"></a>
<a href="https://opencollective.com/mailchimp/sponsor/7/website" target="_blank"><img src="https://opencollective.com/mailchimp/sponsor/7/avatar.svg"></a>
<a href="https://opencollective.com/mailchimp/sponsor/8/website" target="_blank"><img src="https://opencollective.com/mailchimp/sponsor/8/avatar.svg"></a>
<a href="https://opencollective.com/mailchimp/sponsor/9/website" target="_blank"><img src="https://opencollective.com/mailchimp/sponsor/9/avatar.svg"></a>

Release Notes

.NET Standard 1.3
.NETFramework 4.5

This package is not used by any popular GitHub repositories.

Version History

Version Downloads Last updated
4.2.1 72 9/17/2019
4.2.0 5,306 7/31/2019
4.1.0 15,215 5/19/2019
4.0.0 10,273 3/28/2019
3.5.0 36,164 12/6/2018
3.4.0 19,129 10/2/2018
3.3.0 42,188 7/14/2018
3.2.0 79,338 3/11/2018
3.1.1-alpha 4,866 11/12/2017
3.1.0-alpha 252 11/11/2017
3.0.0 43,018 9/4/2017
2.1.0 30,632 7/14/2017
2.0.0 20,910 6/6/2017
1.9.5 12,961 3/30/2017
1.9.1 22,385 2/26/2017
1.9.0 3,374 2/13/2017
1.8.5 16,969 12/18/2016
1.8.0 15,071 11/11/2016
1.7.5 39,929 9/22/2016
1.7.1 3,709 8/30/2016
1.7.0 975 8/22/2016
1.6.7 1,926 7/24/2016
1.6.6 921 7/15/2016
1.6.5 516 7/14/2016
1.6.0 773 7/11/2016
1.5.4 1,750 6/22/2016
1.5.3 686 6/14/2016
1.5.2 456 6/13/2016
1.5.1 447 6/8/2016
1.5.0 625 5/31/2016
1.4.5 636 5/9/2016
1.4.4 335 5/5/2016
1.4.3 296 5/5/2016
1.4.2 1,964 5/2/2016
1.4.1 665 4/20/2016
1.4.0 509 4/19/2016
1.3.1 446 4/16/2016
1.3.0 544 3/23/2016
1.2.6 15,039 3/10/2016
1.2.5 727 1/24/2016
1.2.0 497 1/13/2016
1.0.7.1 398 1/6/2016
1.0.7 348 1/6/2016
1.0.6 307 1/5/2016
1.0.5 323 1/4/2016
1.0.4 304 12/31/2015
1.0.3 351 12/22/2015
1.0.1 463 12/17/2015
1.0.0.23958 529 12/16/2015
1.0.0.20990 338 12/22/2015
1.0.0 560 12/16/2015