Objective-C

Append (Upload) an Email to an IMAP Mailbox

Demonstrates the Chilkat Imap.AppendMail method, which uploads an Email object to a mailbox on the server. The first argument is the destination mailbox name and the second is the Email. After a successful append, the AppendUid property holds the UID the server assigned (or 0 if none was reported). This example uploads a newly built message to the Drafts mailbox.

Background: The IMAP APPEND command lets a client add a message directly to any mailbox without sending it through SMTP — it is how "Save to Drafts" works, and how a client keeps its own copy in Sent. The initial \Seen state is governed by the AppendSeen property (or by the flag arguments of the AppendMimeWithFlags variants).

Chilkat Objective-C Downloads

Download Chilkat for Objective-C

Objective-C

#import <CkoImap.h>
#import <CkoEmail.h>

BOOL success = NO;

//  Demonstrates the Imap.AppendMail method, which uploads an Email object to a mailbox on the
//  server.  The 1st argument is the destination mailbox name and the 2nd is the Email.

CkoImap *imap = [[CkoImap alloc] init];

imap.Ssl = YES;
imap.Port = [NSNumber numberWithInt:993];

success = [imap Connect: @"imap.example.com"];
if (success == NO) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

success = [imap Login: @"user@example.com" password: @"myPassword"];
if (success == NO) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

//  Build the email to be uploaded.
CkoEmail *email = [[CkoEmail alloc] init];
email.Subject = @"Meeting agenda";
email.From = @"Alice <alice@example.com>";
success = [email AddTo: @"Bob" emailAddress: @"bob@example.com"];
email.Body = @"Let's meet at 10am to review the agenda.";

//  Append (upload) the email to the "Drafts" mailbox.
success = [imap AppendMail: @"Drafts" email: email];
if (success == NO) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

//  AppendUid holds the UID assigned by the server (0 if the server did not report one).
NSLog(@"%@%d",@"Appended UID: ",[imap.AppendUid intValue]);

success = [imap Disconnect];
if (success == NO) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}