This .NET library is a client for version 3 of the Mailjet API.
Every code examples can be found on the Mailjet Documentation
(Please refer to the Mailjet Documentation Repository to contribute to the documentation examples)
This .NET library is supported by :
- .NET Core 1.0
- .NET Framework 4.5
- Mono 4.6
- Xamarin.iOS 10.0
- Xamarin.Android 7.0
- Universal Windows Platform 10
- Windows 8.0
- Windows Phone 8.1
Make sure you have a Mailjet API Key and Secret Key. Both API key and API secret can be found here after opening a Mailjet account.
Alternatively for V4 namespace you will need a Bearer token. To generate a new token, please go Mailjet's SMS Dashboard and click on 'Generate a token'.
Any additional information can be found here.
- NETStandard.Library (>= 1.6.1)
- Newtonsoft.Json (>= 9.0.1)
You can either clone the present Github repository or use NuGet package manager whit the following command
PM> Install-Package Mailjet.Api
For more information about our Nuget package, follow this link
using Mailjet.Client;
using Mailjet.Client.Resources;
using System;
using System.Configuration;
using System.Threading.Tasks;
namespace Mailjet.ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
RunAsync().Wait();
}
static async Task RunAsync()
{
MailjetClient client = new MailjetClient(ConfigurationManager.AppSettings["apiKey"], ConfigurationManager.AppSettings["apiSecret"]);
MailjetRequest request = new MailjetRequest
{
Resource = Contact.Resource,
};
MailjetResponse response = await client.GetAsync(request);
if (response.IsSuccessStatusCode)
{
Console.WriteLine(string.Format("Total: {0}, Count: {1}\n", response.GetTotal(), response.GetCount()));
Console.WriteLine(response.GetData());
}
else
{
Console.WriteLine(string.Format("StatusCode: {0}\n", response.StatusCode));
Console.WriteLine(string.Format("ErrorInfo: {0}\n", response.GetErrorInfo()));
Console.WriteLine(string.Format("ErrorMessage: {0}\n", response.GetErrorMessage()));
}
Console.ReadLine();
}
}
}To use filter use the following code:
MailjetRequest request = new MailjetRequest
{
Resource = Contact.Resource,
}
.Filter("limit", 178);using Mailjet.Client;
using Mailjet.Client.Resources;
using System;
using System.Configuration;
using System.Threading.Tasks;
namespace Mailjet.ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
RunAsync().Wait();
}
static async Task RunAsync()
{
MailjetClient client = new MailjetClient(ConfigurationManager.AppSettings["apiKey"], ConfigurationManager.AppSettings["apiSecret"]);
MailjetRequest request = new MailjetRequest()
{
Resource = Contact.Resource,
}
.Property(Contact.Email, "Mister@mailjet.com");
MailjetResponse response = await client.PostAsync(request);
Console.WriteLine(string.Format("StatusCode: {0}\n", response.StatusCode));
if (response.IsSuccessStatusCode)
{
Console.WriteLine(string.Format("Total: {0}, Count: {1}\n", response.GetTotal(), response.GetCount()));
Console.WriteLine(response.GetData());
}
else
{
Console.WriteLine(string.Format("ErrorInfo: {0}\n", response.GetErrorInfo()));
Console.WriteLine(string.Format("ErrorMessage: {0}\n", response.GetErrorMessage()));
}
Console.ReadLine();
}
}
}using Mailjet.Client;
using Mailjet.Client.Resources;
using System;
using Newtonsoft.Json.Linq;
namespace Mailjet.ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
MailjetClient client = new MailjetClient(ConfigurationManager.AppSettings["apiKey"], ConfigurationManager.AppSettings["apiSecret"]);
MailjetRequest request = new MailjetRequest
{
Resource = Contact.Resource,
ResourceId = ResourceId.Alphanumeric("mister@mailjet.com"),
Body = new JObject
{
{ Contact.Name, "Mister Mailjet" },
},
};
MailjetResponse response = client.PutAsync(request).Result;
if (response.IsSuccessStatusCode)
{
Console.WriteLine(string.Format("Total: {0}, Count: {1}\n", response.GetTotal(), response.GetCount()));
Console.WriteLine(response.GetData());
}
else
{
Console.WriteLine(string.Format("StatusCode: {0}\n", response.StatusCode));
Console.WriteLine(string.Format("ErrorInfo: {0}\n", response.GetErrorInfo()));
Console.WriteLine(string.Format("ErrorMessage: {0}\n", response.GetErrorMessage()));
}
Console.ReadLine();
}
}
}Using the resource ID (ResourceId.Numeric):
using Mailjet.Client;
using Mailjet.Client.Resources;
using System;
using System.Configuration;
using System.Threading.Tasks;
namespace Mailjet.ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
RunAsync().Wait();
}
static async Task RunAsync()
{
MailjetClient client = new MailjetClient(ConfigurationManager.AppSettings["apiKey"], ConfigurationManager.AppSettings["apiSecret"]);
MailjetRequest request = new MailjetRequest()
{
Resource = Contact.Resource,
ResourceId = ResourceId.Numeric(1727238050),
};
MailjetResponse response = await client.GetAsync(request);
Console.WriteLine(string.Format("StatusCode: {0}\n", response.StatusCode));
if (response.IsSuccessStatusCode)
{
Console.WriteLine(string.Format("Total: {0}, Count: {1}\n", response.GetTotal(), response.GetCount()));
Console.WriteLine(response.GetData());
}
else
{
Console.WriteLine(string.Format("ErrorInfo: {0}\n", response.GetErrorInfo()));
Console.WriteLine(string.Format("ErrorMessage: {0}\n", response.GetErrorMessage()));
}
Console.ReadLine();
}
}
}Using the resource alternate ID (ResourceId.Alphanumeric):
using Mailjet.Client;
using Mailjet.Client.Resources;
using System;
using System.Configuration;
using System.Threading.Tasks;
namespace Mailjet.ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
RunAsync().Wait();
}
static async Task RunAsync()
{
MailjetClient client = new MailjetClient(ConfigurationManager.AppSettings["apiKey"], ConfigurationManager.AppSettings["apiSecret"]);
MailjetRequest request = new MailjetRequest()
{
Resource = Contact.Resource,
ResourceId = ResourceId.Alphanumeric("mister@mailjet.com"),
};
MailjetResponse response = await client.GetAsync(request);
Console.WriteLine(string.Format("StatusCode: {0}\n", response.StatusCode));
if (response.IsSuccessStatusCode)
{
Console.WriteLine(string.Format("Total: {0}, Count: {1}\n", response.GetTotal(), response.GetCount()));
Console.WriteLine(response.GetData());
}
else
{
Console.WriteLine(string.Format("ErrorInfo: {0}\n", response.GetErrorInfo()));
Console.WriteLine(string.Format("ErrorMessage: {0}\n", response.GetErrorMessage()));
}
Console.ReadLine();
}
}
}using Mailjet.Client;
using Mailjet.Client.Resources;
using System;
namespace Mailjet.ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
MailjetClient client = new MailjetClient(ConfigurationManager.AppSettings["apiKey"], ConfigurationManager.AppSettings["apiSecret"]);
MailjetRequest request = new MailjetRequest
{
Resource = Listrecipient.Resource,
ResourceId = ResourceId.Numeric(956611829),
};
MailjetResponse response = client.DeleteAsync(request).Result;
if (response.IsSuccessStatusCode)
{
Console.WriteLine(string.Format("Total: {0}, Count: {1}\n", response.GetTotal(), response.GetCount()));
Console.WriteLine(response.GetData());
}
else
{
Console.WriteLine(string.Format("StatusCode: {0}\n", response.StatusCode));
Console.WriteLine(string.Format("ErrorInfo: {0}\n", response.GetErrorInfo()));
Console.WriteLine(string.Format("ErrorMessage: {0}\n", response.GetErrorMessage()));
}
Console.ReadLine();
}
}
}Don't forget to set and validate your sender before trying the following code.
using Mailjet.Client;
using Mailjet.Client.Resources;
using System;
using Newtonsoft.Json.Linq;
namespace Mailjet.ConsoleApplication
{
class Program
{
/// <summary>
/// This calls sends an email to one recipient.
/// </summary>
static void Main(string[] args)
{
RunAsync().Wait();
}
static async Task RunAsync()
{
MailjetClient client = new MailjetClient(Environment.GetEnvironmentVariable("MJ_APIKEY_PUBLIC"), Environment.GetEnvironmentVariable("MJ_APIKEY_PRIVATE"));
MailjetRequest request = new MailjetRequest
{
Resource = Send.Resource,
}
.Property(Send.FromEmail, "pilot@mailjet.com")
.Property(Send.FromName, "Mailjet Pilot")
.Property(Send.Subject, "Your email flight plan!")
.Property(Send.TextPart, "Dear passenger, welcome to Mailjet! May the delivery force be with you!")
.Property(Send.HtmlPart, "<h3>Dear passenger, welcome to Mailjet!</h3><br />May the delivery force be with you!")
.Property(Send.Recipients, new JArray {
new JObject {
{"Email", "passenger@mailjet.com"}
}
});
MailjetResponse response = await client.PostAsync(request);
if (response.IsSuccessStatusCode)
{
Console.WriteLine(string.Format("Total: {0}, Count: {1}\n", response.GetTotal(), response.GetCount()));
Console.WriteLine(response.GetData());
}
else
{
Console.WriteLine(string.Format("StatusCode: {0}\n", response.StatusCode));
Console.WriteLine(string.Format("ErrorInfo: {0}\n", response.GetErrorInfo()));
Console.WriteLine(string.Format("ErrorMessage: {0}\n", response.GetErrorMessage()));
}
}
}
}For V4 namespace the authorization method is changed - now it is based on Bearer token.
To use Bearer token you will need to replace client clientin from:
...
MailjetClient client = new MailjetClient(ConfigurationManager.AppSettings["apiKey"], ConfigurationManager.AppSettings["apiSecret"]);
...with
...
MailjetClient client = new MailjetClient(ConfigurationManager.AppSettings["bearerToken"]);
...We welcome any contribution.
Please make sure you follow this step-by-step guide before contributing :
- Fork the project.
- Create a topic branch.
- Implement your feature or bug fix.
- Add documentation for your feature or bug fix.
- Commit and push your changes.
- Submit a pull request
Submit your issues here.