(Objective-C) Mailgun Send Simple Email

See more Mailgun Examples

Send a simple email 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 <CkoHttp.h>
#import <CkoHttpRequest.h>
#import <CkoHttpResponse.h>
#import <CkoStringBuilder.h>
#import <CkoJsonObject.h>
#import <NSString.h>

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

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

// 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 = [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"];