(Objective-C) Outlook Send HTML Email

This example sends an HTML email. Other examples exist for:

Sending plain-text email.
Sending HTML email with embedded images.
Sending email with attachments.
Sending HTML email with embedded images and attachments.

Note: This example requires Chilkat v9.5.0.68 or greater.

Chilkat Objective-C Library Downloads

MAC OS X (Cocoa) Libs

iOS Libs

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

// Important: This example requires Chilkat v9.5.0.68 or greater.

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

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

// Use your previously obtained access token here:
// See the following examples for getting an access token:
//    Get Microsoft Graph OAuth2 Access Token (Azure AD v2.0 Endpoint).
//    Get Microsoft Graph OAuth2 Access Token (Azure AD Endpoint).
//    Refresh Access Token (Azure AD v2.0 Endpoint).
//    Refresh Access Token (Azure AD Endpoint).

http.AuthToken = @"MICROSOFT_GRAPH_ACCESS_TOKEN";

// To send mail, we'll POST to the following endpoint:
// 
// POST /users/{id | userPrincipalName}/sendMail
// 
// (The special keyword "me" may be used in place of a principal name.)
// 

// This example will send HTML email containing the following HTML body:

// 	<html>
// 	<head>
// 	<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
// 	<meta content="text/html; charset=utf-8">
// 	</head>
// 	<body bgcolor="#FFFFFF">
// 	<font face="Calibri">This is a test <b>HTML email</b>.<br>
// 	</font>
// 	</body>
// 	</html>

// Build the HTML body...
BOOL bCrlf = YES;
CkoStringBuilder *sbHtmlBody = [[CkoStringBuilder alloc] init];
[sbHtmlBody AppendLine: @"<html>" crlf: bCrlf];
[sbHtmlBody AppendLine: @"<head>" crlf: bCrlf];
[sbHtmlBody AppendLine: @"<meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">" crlf: bCrlf];
[sbHtmlBody AppendLine: @"<meta content=\"text/html; charset=utf-8\">" crlf: bCrlf];
[sbHtmlBody AppendLine: @"</head>" crlf: bCrlf];
[sbHtmlBody AppendLine: @"<body bgcolor=\"#FFFFFF\">" crlf: bCrlf];
[sbHtmlBody AppendLine: @"<font face=\"Calibri\">This is a test <b>HTML email</b>.<br>" crlf: bCrlf];
[sbHtmlBody AppendLine: @"</font>" crlf: bCrlf];
[sbHtmlBody AppendLine: @"</body>" crlf: bCrlf];
[sbHtmlBody AppendLine: @"</html>" crlf: bCrlf];

// The body of the POST request contains JSON that specifies the email subject, body,
// recipients, etc.  This example will build the following JSON HTML email:
// 

// 	{
// 	  "message": {
// 	    "subject": "Sample HTML Email",
// 	    "body": {
// 	      "contentType": "html",
// 	      "content": "The HTML body goes here..."
// 	    },
// 	    "toRecipients": [
// 	      {
// 	        "emailAddress": {
// 		  "name": "Chilkat Software",
// 	          "address": "admin@chilkat.io"
// 	        }
// 	      },
// 	      {
// 	        "emailAddress": {
// 	          "address": "chilkat.support@gmail.com"
// 	        }
// 	      }
// 	    ],
// 	    "ccRecipients": [
// 	      {
// 	        "emailAddress": {
// 		  "name": "Chilkat Blog",
// 		  "address": "admin@cknotes.com"
// 	        }
// 	      }
// 	    ]
// 	  },
// 	  "saveToSentItems": true
// 	}
// 

// Build the above JSON.
CkoJsonObject *json = [[CkoJsonObject alloc] init];
[json UpdateString: @"message.subject" value: @"Sample HTML email"];
[json UpdateString: @"message.body.contentType" value: @"html"];
[json UpdateString: @"message.body.content" value: [sbHtmlBody GetAsString]];
[json UpdateString: @"message.toRecipients[0].emailAddress.name" value: @"Chilkat Software"];
[json UpdateString: @"message.toRecipients[0].emailAddress.address" value: @"admin@chilkat.io"];
[json UpdateString: @"message.toRecipients[1].emailAddress.address" value: @"chilkat.support@gmail.com"];
[json UpdateString: @"message.ccRecipients[0].emailAddress.name" value: @"Chilkat Blog"];
[json UpdateString: @"message.ccRecipients[0].emailAddress.address" value: @"admin@cknotes.com"];
[json UpdateBool: @"saveToSentItems" value: YES];

// -------------------------------------------------------------
// Important: This example requires Chilkat v9.5.0.68 or greater.
// -------------------------------------------------------------

// Send the HTTP POST (i.e. send the HTML email)
CkoHttpResponse *resp = [http PostJson2: @"https://graph.microsoft.com/v1.0/me/sendMail" contentType: @"application/json" jsonText: [json Emit]];
if (http.LastMethodSuccess != YES) {
    NSLog(@"%@",http.LastErrorText);
    return;
}

// The send succeeded if the response status code = 202.
// In the success case, there is no response body.  (We just get the response code to know that it succeeded.)
if ([resp.StatusCode intValue] != 202) {
    [json Load: resp.BodyStr];
    json.EmitCompact = NO;
    NSLog(@"%@",[json Emit]);
    NSLog(@"%@%d",@"Failed, response status code = ",[resp.StatusCode intValue]);
}
else {
    NSLog(@"%@",@"Outlook HTML Mail Sent.");
}