Sample code for 30+ languages & platforms
Objective-C Requires Chilkat v11.0.0+

SendGrid: Attach a PDF invoice to an email

See more SendGrid Examples

Read invoice.pdf from the working directory and send it as a downloadable file named invoice-1042.pdf. SendGrid expects Base64 file content in the JSON request, not a path or a multipart upload. The whole message, including attachments, must be under 30 MB; allow for Base64 to add about a third to the file size.

Use an API key with Mail Send permission and a verified sender identity. Replace the example addresses before sending.

SendGrid documentation: Mail Send size limits.

Chilkat Objective-C Downloads

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

//  Assumes Chilkat is unlocked. See Global Unlock Sample.
CkoHttp *http = [[CkoHttp alloc] init];
http.RequireSslCertVerify = YES;
//  Supply a Mail Send API key from your application configuration. AuthToken adds the Bearer prefix.
http.AuthToken = @"SENDGRID_API_KEY";

CkoJsonObject *message = [[CkoJsonObject alloc] init];
//  Replace the sender with a verified sender identity and the recipient with your destination.
[message UpdateString: @"from.email" value: @"sender@example.com"];
[message UpdateString: @"personalizations[0].to[0].email" value: @"recipient@example.com"];
[message UpdateString: @"subject" value: @"Invoice 1042"];
[message UpdateString: @"content[0].type" value: @"text/plain"];
[message UpdateString: @"content[0].value" value: @"Your invoice is attached as invoice-1042.pdf."];

CkoBinData *fileData = [[CkoBinData alloc] init];
BOOL loaded = [fileData LoadFile: @"invoice.pdf"];
if (loaded != YES) {
    NSLog(@"%@",@"Could not read invoice.pdf. Check the path and file permissions.");
    return;
}

if ([fileData.NumBytes intValue] == 0) {
    NSLog(@"%@",@"invoice.pdf is empty.");
    return;
}

//  Encode the file bytes once. The content field contains only Base64, without a data URI prefix.
[message UpdateString: @"attachments[0].content" value: [fileData GetEncoded: @"base64"]];
[message UpdateString: @"attachments[0].type" value: @"application/pdf"];
[message UpdateString: @"attachments[0].filename" value: @"invoice-1042.pdf"];
[message UpdateString: @"attachments[0].disposition" value: @"attachment"];

CkoHttpResponse *response = [[CkoHttpResponse alloc] init];
[http HttpJson: @"POST" url: @"https://api.sendgrid.com/v3/mail/send" json: message contentType: @"application/json" response: response];
//  HttpJson also returns false for HTTP errors. A zero status means no HTTP response arrived.
if ([response.StatusCode intValue] == 0) {
    NSLog(@"%@",http.LastErrorText);
    return;
}

if ([response.StatusCode intValue] != 202) {
    NSLog(@"%@%d",@"Mail Send returned HTTP ",[response.StatusCode intValue]);
    //  For validation errors the response body identifies the offending field and explains why.
    NSLog(@"%@",response.BodyStr);
    return;
}

NSLog(@"%@",@"SendGrid accepted the email for delivery (HTTP 202).");