Objective-C

Mailgun Send Simple Email

See more Mailgun Examples

Send a simple email using Mailgun. Objective-C

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

BOOL success = NO;

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

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

// Implements the following CURL command:

// curl -s --user 'api:SENDING_API_KEY' 
// 	 https://api.mailgun.net/v3/YOUR_DOMAIN_NAME/messages 
// 	 -F from='Your Name <mailgun@YOUR_DOMAIN_NAME>' 
// 	 -F to='Joe Example <joe@example.com>' 
// 	 -F subject='Hello Joe Example' 
// 	 -F text='Congratulations Joe Example, you just sent an email with Mailgun!  You are truly awesome!'

// Use the following online tool to generate HTTP code from a CURL command
// Convert a cURL Command to HTTP Source Code

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";
req.ContentType = @"multipart/form-data";

// Change YOUR_DOMAIN_NAME to something like "mg.your-domain.com".
[req AddParam: @"from" value: @"Your Name <mailgun@YOUR_DOMAIN_NAME>"];
[req AddParam: @"to" value: @"Joe Example <joe@example.com>"];
[req AddParam: @"subject" value: @"Hello Joe Example"];
[req AddParam: @"text" value: @"Congratulations Joe Example, you just sent an email with Mailgun!  You are truly awesome!"];

CkoHttpResponse *resp = [[CkoHttpResponse alloc] init];
success = [http HttpSReq: @"api.mailgun.net" port: [NSNumber numberWithInt: 443] ssl: YES request: req response: resp];
if (success == 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"];