LEGACY

New version of API - https://github.com/ElasticEmail/elasticemail-csharp

This library allows you to quickly and easily use the Elastic Email Web API v2 via C# with .NET.

Version 1.X.X+ of this library provides full support for all Elastic Email Web API v2 endpoints.

We want this library to be community driven and Elastic Email led. We need your help to realize this goal. To help make sure we are building the right things in the right order, we ask that you create issues or simply upvote or comment on existing issues or pull requests.

Please browse the rest of this README for further detail.

We appreciate your continued support, thank you!

Table of Contents

• Installation
• Quick Start
• About

Installation

Prerequisites

• .NET version 4.5.2 or higher
• An Elastic Email account

  Install Package

  To use ElasticEmail in your C# project, you can download the ElasticEmail C# .NET libraries directly from our Github repository or, if you have the NuGet package manager installed, you can grab them automatically.

PM> Install-Package ElasticEmail.WebApiClient

Once you have the ElasticEmail.WebApiClient libraries properly referenced in your project, you can include calls to them in your code.

Quick Start

Send Email

The following is the minimum needed code to send an simple email:

using static ElasticEmailClient.Api;
using static ElasticEmailClient.ApiTypes;

namespace SendEmailExample
{
    class Program
    {
        static void Main(string[] args)
        {
            ApiKey = "YOUR-API-KEY";

            var sendResult = SendEmail("Hello World from Elastic Email!", "fromAddress@exmple.com", "John Tester", new string[] { "toAddress@exmple.com" },
                                        "<h1>Hello! This mail was sent by Elastic Email service.<h1>", "Hello! This mail was sent by Elastic Email service.");

            Console.WriteLine("MsgID to store locally: " + sendResult.MessageID); // Available only if sent to a single recipient
            Console.WriteLine("TransactionID to store locally: " + sendResult.TransactionID);
        }

        public static EmailSend SendEmail(string subject, string fromEmail, string fromName, string[] msgTo, string html, string text)
        {
            try
            {
                return Email.Send(subject, fromEmail, fromName, msgTo: msgTo, bodyHtml: html, bodyText: text);
            }
            catch (Exception ex)
            {
                if (ex is ApplicationException)
                    Console.WriteLine("Server didn't accept the request: " + ex.Message);
                else
                    Console.WriteLine("Something unexpected happened: " + ex.Message);

                return null;
            }
        }
    }
}

Load Account

This is a simple example on how to download your Account's information:

namespace LoadAccountExample
{
    class Program
    {
        static void Main(string[] args)
        {
            ApiKey = "YOUR-API-KEY";

            var account = LoadAccount();

            Console.WriteLine(account.PricePerEmail);
        }

        public static ElasticEmailClient.ApiTypes.Account LoadAccount()
        {
            try
            {
                return ElasticEmailClient.Api.Account.Load();
            }
            catch (Exception ex)
            {
                if (ex is ApplicationException)
                    Console.WriteLine("Server didn't accept the request: " + ex.Message);
                else
                    Console.WriteLine("Something unexpected happened: " + ex.Message);

                return null;
            }
        }
    }
}

About

ElasticEmail.WebApiClient-csharp is guided and supported by the ElasticEmail Dev Team.

ElasticEmail.WebApiClient-csharp is maintained and funded by Elastic Email Inc. The names and logos for ElasticEmail.WebApiClien-csharp are trademarks of Elastic Email Inc.