Sample code for 30+ languages & platforms
Objective-C

SendGrid HTML Email with Embedded Images

See more SendGrid Examples

Demonstrates how to send an HTML email with embedded images using SendGrid.

Chilkat Objective-C Downloads

Objective-C
#import <CkoHttpRequest.h>
#import <CkoHttp.h>
#import <CkoBinData.h>
#import <CkoStringBuilder.h>
#import <CkoJsonObject.h>
#import <CkoHttpResponse.h>

BOOL success = NO;

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

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

// First.. load a JPG file and build an HTML img tag with the JPG data inline encoded.
// Our HTML img tag will look like this:
// <img src="data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEA3ADcAA..." alt="" style="border-width:0px;" />
CkoBinData *bdJpg = [[CkoBinData alloc] init];
success = [bdJpg LoadFile: @"qa_data/jpg/starfish.jpg"];
if (success == NO) {
    NSLog(@"%@",@"Failed to load JPG file.");
    return;
}

// Note: HTML containing embedded base64 image data may not be visible in all email clients.
// For example, GMail might not display the image, but viewing in Outlook might be OK.
CkoStringBuilder *sbHtml = [[CkoStringBuilder alloc] init];
[sbHtml Append: @"<html><body><b>This is a test<b><br /><img src=\"data:image/jpeg;base64,"];
// Append the base64 image data to sbHtml.
[bdJpg GetEncodedSb: @"base64" sb: sbHtml];
[sbHtml Append: @"\" alt=\"\" style=\"border-width:0px;\" /></body></html>"];

CkoJsonObject *json = [[CkoJsonObject alloc] init];
[json UpdateString: @"personalizations[0].to[0].email" value: @"matt@chilkat.io"];
[json UpdateString: @"personalizations[0].to[0].name" value: @"Matt"];
[json UpdateString: @"from.email" value: @"admin@chilkatsoft.com"];
[json UpdateString: @"subject" value: @"Test HTML email with images"];
[json UpdateString: @"content[0].type" value: @"text/html"];
[json UpdateSb: @"content[0].value" sb: sbHtml];

http.AuthToken = @"SENDGRID_API_KEY";

CkoHttpResponse *resp = [[CkoHttpResponse alloc] init];
success = [http HttpJson: @"POST" url: @"https://api.sendgrid.com/v3/mail/send" json: json contentType: @"application/json" response: resp];
if (success == NO) {
    NSLog(@"%@",http.LastErrorText);
    return;
}

NSLog(@"%@%d",@"response status code: ",[resp.StatusCode intValue]);
// Display the response.
// If successful, the response code is 202 and the response body string is empty.
// (The response body string may also be empty for error response codes.)
NSLog(@"%@",resp.BodyStr);