Mailpress SMTP Mail Engine API Documentation
You have a killer email marketing campaign locked and loaded. Now, how to send it to the 2000 or 2 million email addresses on your contact list? For most marketers, an email service provider (ESP) is the answer to reliably and effectively delivering mass email without the hassle or costs of trying to do it yourself. ESPs often provide email marketing software that helps you manage and deliver your messages. However, using an email service doesn't mean you'll break the bank sending content to your subscribers. We offer comprehensive deliverability features and powerful marketing automation tools without breaking local laws.
Below are the endpoints for accessing On-Demand Mail Engine. Learn how to integrate the API into your application.
Authorization:
- privateId *Specify privateId for site
(e.g., "Bearer example^com-SomeIdString").
Query Parameters:
- type Specify type of SES
for Transactional OTP (e.g., type:"OTP").
for Promotional Bulk (e.g., type:"TMP").
for Informational personalized (e.g., type:"CXT").
Body Parameters:
- mailId Specify the array of mail address
(e.g., ["email@domain.com"]). - :data Specify the mail OTP|TMP|CXT string
for Transactional OTP (e.g., OTP:"000000").
for Promotional Bulk (e.g., TMP:"template-id-here").
for Informational personalized (e.g., CXT:"html-email").
Route Parameters:
- :region *Please check location table here
(e.g., "WEST_3|ARAB_1|EAST_3|NORD_6").
Response based on params:
{
"success": true,
"info": "SES OTP Sent!"
}This endpoint provides the mail for sending bulk email.
using System;
using System.Net.Http;
using System.Text;
using System.Text.Json;
using System.Threading.Tasks;
public class ApiClient
{
private static readonly string BaseUrl = "https://mailpress.api.koirang.com/v1/:region";
private static readonly string PrivateId = "<privateId>";
static async Task Main(string[] args)
{
try
{
var result = await FetchDataAsync();
Console.WriteLine(JsonSerializer.Serialize(result, new JsonSerializerOptions
{
WriteIndented = true
}));
}
catch (Exception ex)
{
Console.WriteLine($"Error: {ex.Message}");
}
}
private static async Task<object> FetchDataAsync()
{
using var client = new HttpClient();
// Build URL
var parameters = new Dictionary<string, string>
{
{ "region", "YOUR_REGION" } // Replace with actual region value
};
var urlBuilder = new StringBuilder(BaseUrl);
foreach (var param in ["region"])
{
urlBuilder.Append($"/{Uri.EscapeDataString(parameters[param])}");
}
// Add query parameters
var queryParams = {"mailId":"example@domain.com","OTP":"000000"};
urlBuilder.Append("?");
foreach (var param in queryParams)
{
urlBuilder.Append($"{param.Key}={Uri.EscapeDataString(param.Value)}&");
}
// Set headers
client.DefaultRequestHeaders.Add("Authorization", $"Bearer {PrivateId}");
// Create request
var request = new HttpRequestMessage(new HttpMethod("GET"), urlBuilder.ToString());
if ("GET" == "POST" || "GET" == "PUT")
{
var content = JsonSerializer.Serialize({"type":"OTP"});
request.Content = new StringContent(content, Encoding.UTF8, "application/json");
}
// Send request
var response = await client.SendAsync(request);
if (!response.IsSuccessStatusCode)
{
throw new HttpRequestException($"HTTP error! status: {response.StatusCode}");
}
var responseContent = await response.Content.ReadAsStringAsync();
return JsonSerializer.Deserialize<object>(responseContent);
}
}