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

Insert an EML file into the Gmail inbox

See more GMail REST API Examples

Read an existing message.eml as bytes and insert it into the authenticated mailbox with the INBOX label in the same request. This stores a message without delivering it to recipients. Insert bypasses most scanning and classification. For mail that should undergo normal inbound processing, see messages.import.

Authorize the application with https://www.googleapis.com/auth/gmail.insert. The example reads the access token from gmail-token.json in a private working directory. Authorize a desktop application.

Google documentation

Chilkat Objective-C Downloads

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

BOOL success = NO;

//  Assumes Chilkat is unlocked. See Global Unlock Sample.

CkoJsonObject *token = [[CkoJsonObject alloc] init];
success = [token LoadFile: @"gmail-token.json"];
if (success != YES) {
    NSLog(@"%@",@"Could not read gmail-token.json from the private working directory.");
    return;
}

if (([[token JsonTypeOf: @"access_token"] intValue] != 1) || ([token StringOfEquals: @"access_token" value: @"" caseSensitive: YES] == YES)) {
    NSLog(@"%@",@"An OAuth access token is required.");
    return;
}

CkoHttp *http = [[CkoHttp alloc] init];
http.RequireSslCertVerify = YES;
http.AuthToken = [token StringOf: @"access_token"];
CkoHttpResponse *resp = [[CkoHttpResponse alloc] init];
CkoJsonObject *reply = [[CkoJsonObject alloc] init];
CkoBinData *mime = [[CkoBinData alloc] init];
success = [mime LoadFile: @"message.eml"];
if (success != YES) {
    NSLog(@"%@",@"Could not read message.eml.");
    return;
}

CkoJsonObject *request = [[CkoJsonObject alloc] init];
success = [request UpdateBd: @"raw" encoding: @"base64url" bd: mime];
if (success != YES) {
    NSLog(@"%@",request.LastErrorText);
    return;
}

[request UpdateString: @"labelIds[0]" value: @"INBOX"];
success = [http HttpJson: @"POST" url: @"https://gmail.googleapis.com/gmail/v1/users/me/messages" json: request contentType: @"application/json" response: resp];
if ([resp.StatusCode intValue] == 0) {
    NSLog(@"%@",@"Gmail did not return an HTTP response.");
    return;
}

if ((success != YES) || ([resp.StatusCode intValue] < 200) || ([resp.StatusCode intValue] >= 300)) {
    NSLog(@"%@%d",@"Gmail HTTP ",[resp.StatusCode intValue]);
    success = [reply Load: resp.BodyStr];
    if (success == YES) {
        NSLog(@"%@",[reply StringOf: @"error.message"]);
    }

    return;
}

success = [reply Load: resp.BodyStr];
if (success != YES) {
    NSLog(@"%@",@"Expected a Gmail JSON response.");
    return;
}

if (([[reply JsonTypeOf: @"id"] intValue] != 1) || ([reply StringOfEquals: @"id" value: @"" caseSensitive: YES] == YES)) {
    NSLog(@"%@",@"Expected id in the response.");
    return;
}

NSLog(@"%@%@",@"Gmail message ID: ",[reply StringOf: @"id"]);