(Objective-C) Mailgun Send Email using MIME

See more Mailgun Examples

Send an email using MIME. This allows for the Chilkat email object to be used to construct the email. Then it can be sent using Mailgun.

For more information, see https://documentation.mailgun.com/en/latest/api-sending.html#sending

Chilkat Objective-C Library Downloads

MAC OS X (Cocoa) Libs

iOS Libs

#import <CkoEmail.h>
#import <NSString.h>
#import <CkoHttp.h>
#import <CkoHttpRequest.h>
#import <CkoHttpResponse.h>
#import <CkoStringBuilder.h>
#import <CkoJsonObject.h>

// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

// We're going to create an email that contains an .zip attachment,
// and also both plain-text and HTML alternative bodies.
// The HTML body will include an image.

CkoEmail *email = [[CkoEmail alloc] init];

// Adding attachments, HTML/plain-text bodies, etc can be done
// in any order:

// Add an attachment
NSString *contentType = [email AddFileAttachment: @"qa_data/hamlet.zip"];
if (email.LastMethodSuccess != YES) {
    NSLog(@"%@",email.LastErrorText);
    return;
}

// Add some headers:
email.Subject = @"This is a complex email";
// Please change this email address before testing.
BOOL success = [email AddTo: @"Joe Example" emailAddress: @"joe@example.com"];
email.From = @"Your Name <mailgun@YOUR_DOMAIN_NAME>";

// Add a plain-text body:
[email AddPlainTextAlternativeBody: @"This is the plain-text body"];

// Add an image that will be embedded in the HTML body.
success = [email AddRelatedFile2: @"qa_data/jpg/starfish.jpg" filenameInHtml: @"starfish.jpg"];
if (success != YES) {
    NSLog(@"%@",email.LastErrorText);
    return;
}

// Add an HTML body:
NSString *html = 0;
html = @"<html><body><b>This is the HTML body</b><br><img src=\"starfish.jpg\"></body></html>";

[email AddHtmlAlternativeBody: html];

// ------------------------------------------------------------------------
// Send the above email using Mailgun

CkoHttp *http = [[CkoHttp alloc] init];

// Implements the following CURL command:

http.Login = @"api";
http.Password = @"sending_api_key";//  Replace with your actual sending API key.

CkoHttpRequest *req = [[CkoHttpRequest alloc] init];
req.HttpVerb = @"POST";
req.Path = @"/v3/YOUR_DOMAIN_NAME/messages.mime";
req.ContentType = @"multipart/form-data";

[req AddParam: @"from" value: @"Your Name <mailgun@YOUR_DOMAIN_NAME>"];
[req AddParam: @"to" value: @"Joe Example <joe@example.com>"];
[req AddStringForUpload2: @"message" filename: @"message.eml" strData: [email GetMime] charset: @"utf-8" contentType: @"application/octet-stream"];

CkoHttpResponse *resp = [http SynchronousRequest: @"api.mailgun.net" port: [NSNumber numberWithInt: 443] ssl: YES req: req];
if (http.LastMethodSuccess == NO) {
    NSLog(@"%@",http.LastErrorText);
    return;
}

CkoStringBuilder *sbResponseBody = [[CkoStringBuilder alloc] init];
[resp GetBodySb: sbResponseBody];
CkoJsonObject *jResp = [[CkoJsonObject alloc] init];
[jResp LoadSb: sbResponseBody];
jResp.EmitCompact = NO;

NSLog(@"%@",@"Response Body:");
NSLog(@"%@",[jResp Emit]);

int respStatusCode = [resp.StatusCode intValue];
NSLog(@"%@%d",@"Response Status Code = ",respStatusCode);
if (respStatusCode >= 400) {
    NSLog(@"%@",@"Response Header:");
    NSLog(@"%@",resp.Header);
    NSLog(@"%@",@"Failed.");

    return;
}

// Sample JSON response:
// (Sample code for parsing the JSON response is shown below)

// {
//   "id": "<20210429234809.1.2D550E1C94D3D98F@sandbox0e542e4c577f4bbb98c8bf6b6bca727b.mailgun.org>",
//   "message": "Queued. Thank you."
// }

// Sample code for parsing the JSON response...
// Use the following online tool to generate parsing code from sample JSON:
// Generate Parsing Code from JSON

NSString *id = [jResp StringOf: @"id"];
NSString *message = [jResp StringOf: @"message"];