MailChimpWrapper 0.0.1

MailChimpWrapper

This project wraps around the basic MailChimp API, and gives you an easier and more readable solution for requesting data.

Usage

Initialize the client:

MailChimpWrapper.MailChimpClient client = new MailChimpWrapper.MailChimpClient("APIKEY", "SERVER");

Ping

PingResponse pingResult = await client.GetRequest<PingResponse>(Endpoints.Ping);

Root

RootResponse rootresp = await client.GetRequest<RootResponse>(Endpoints.Root);

Lists (Audiences)

Get multiple

ListsResponse listsResult = await client.GetRequest<ListsResponse>(Endpoints.Lists);

Get by id

ListResponse listResult = await client.Request<ListGetRequest, ListResponse>(new ListGetRequest("ID"));

List Members

Post

var listMembers = new List<Member>() { new Member(){
            EmailAddress="emailaddress",
            EmailClient="Outlook",
            Language="En",
            Status="subscribed",
            EmailType="html"
        }
    };
ListMembersResponse listMembersResponse = await client.Request<ListMembersPostRequest, ListMembersResponse>(new ListMembersPostRequest("listId", listMembers));

Member Tags

Get

MemberTagsResponse memberTagsResponse = await client.Request<MemberTagsGetRequest, MemberTagsResponse>(new MemberTagsGetRequest("listId", "emailaddress"));

Add tag to member in list

Note: Because the Api doesn't return any content there is no response.

await client.Request(new MemberTagsPostRequest("listId", "emailaddress", new List<Tag>() { new Tag() { Name = "tagName", Status = "active/inactive" } }));

Campaigns

Get all

var listCampaigns = await client.GetRequest<CampaignsResponse>(Endpoints.Campaigns);

Get by id

CampaignResponse campaign = await client.Request<CampaignGetRequest, CampaignResponse>(new CampaignGetRequest("campaignId"));

Post new

var newCampaign = await client.Request<CampaignNewPostRequest, CampaignResponse>(new CampaignNewPostRequest(CampaignType.regular));

Send/Resend

await client.Request(new CampaignSendRequest(campaign.Id));

await client.Request(new CampaignResendRequest(campaign.Id));

Delete campaign

await client.Request(new CampaignDeleteRequest(campaign.Id));

<b> Guide add List(Audience) to campaign </b>

This guide will explain how to edit a campaign and add you existing audience to it.

1. Get the campaign by id:

CampaignResponse campaign = await client.Request<CampaignGetRequest, CampaignResponse>(new CampaignGetRequest("campaignId"));

2. Edit their Recipients:

Recipients recipients = campaign.Recipients;
recipients.ListId = "listId";

3. Create a campaign edit request, inside the new request add the new recipients:

CampaignEditRequest campaignEditRequest = new CampaignEditRequest(campaign.Id) { Recipients = recipients };

4. Now request the edit of the campaign using the client:

CampaignResponse updatedCampaign = await client.Request<CampaignEditRequest, CampaignResponse>(campaignEditRequest);

Error handling:

try
{
    //request
}
catch (ResponseException responseException)
{
    var message = responseException.ErrorResponse.Detail;
}
catch (UnknownResponseException unknownException)
{
    var response = unknownException.ResponseMessage;
}

Note: This project is in a very early stage!