https://github.com/elasticemail/elasticemail.webapiclient-csharp
Easily send emails with Elastic Email using Web API C# Client https://elasticemail.com/
https://github.com/elasticemail/elasticemail.webapiclient-csharp
Last synced: 9 months ago
JSON representation
Easily send emails with Elastic Email using Web API C# Client https://elasticemail.com/
- Host: GitHub
- URL: https://github.com/elasticemail/elasticemail.webapiclient-csharp
- Owner: ElasticEmail
- License: mit
- Created: 2017-04-24T12:28:15.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2022-12-07T17:26:54.000Z (over 3 years ago)
- Last Synced: 2024-04-14T07:27:31.080Z (about 2 years ago)
- Language: C#
- Homepage:
- Size: 139 KB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
**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](https://github.com/ElasticEmail/ElasticEmail.WebApiClient-csharp/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](https://elasticemail.com/account/)
## Install Package ##
To use ElasticEmail in your C# project, you can [download the ElasticEmail C# .NET libraries directly from our Github repository](https://github.com/ElasticEmail/ElasticEmail.WebApiClient-csharp) 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" },
"
Hello! This mail was sent by Elastic Email service.", "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.
