Objective-C

Outlook Send Email

See more Outlook Examples

This example sends a simple plain-text email. Other examples exist for:

• Sending HTML email.
• Sending HTML email with embedded images.
• Sending email with attachments.
• Sending HTML email with embedded images and attachments.

Objective-C

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

BOOL success = NO;

//  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).

CkoJsonObject *jsonToken = [[CkoJsonObject alloc] init];
success = [jsonToken LoadFile: @"qa_data/tokens/microsoftGraph.json"];
if (success == NO) {
    NSLog(@"%@",jsonToken.LastErrorText);
    return;
}

http.AuthToken = [jsonToken StringOf: @"access_token"];

//  To send email, 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.)
//  

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

//  	{
//  	  "message": {
//  	    "subject": "Meet for lunch?",
//  	    "body": {
//  	      "contentType": "Text",
//  	      "content": "The new cafeteria is open."
//  	    },
//  	    "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: @"Meet for lunch?"];
[json UpdateString: @"message.body.contentType" value: @"Text"];
[json UpdateString: @"message.body.content" value: @"The new cafeteria is open."];
[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];

//  Send the HTTP POST (i.e. send the email)
CkoHttpResponse *resp = [[CkoHttpResponse alloc] init];
success = [http HttpJson: @"POST" url: @"https://graph.microsoft.com/v1.0/me/sendMail" json: json contentType: @"application/json" response: resp];
if (success == NO) {
    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 Mail Sent.");
}