Sample code for 30+ languages & platforms
Objective-C

IMAP Copy Email from Selected Folder to Another Folder

Copies an email from the selected mailbox (folder) to another mailbox (folder).

Chilkat Objective-C Downloads

Objective-C
#import <CkoImap.h>
#import <NSString.h>
#import <CkoMessageSet.h>

BOOL success = NO;

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

//  This example copies an email from one mailbox to another.
CkoImap *imap = [[CkoImap alloc] init];

//  Turn on session logging for debugging.
imap.KeepSessionLog = YES;

//  Connect using TLS.
imap.Ssl = YES;
imap.Port = [NSNumber numberWithInt:993];
success = [imap Connect: @"imap.example.com"];
if (success == NO) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

//  Authenticate
success = [imap Login: @"email_account_login" password: @"email_account_password"];
if (success == NO) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

//  Select an IMAP mailbox
success = [imap SelectMailbox: @"Inbox"];
if (success == NO) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

//  Search for messages having "Test email" in the subject.
BOOL fetchUids = YES;
NSString *criteria = @"SUBJECT \"Test email\"";
CkoMessageSet *messageSet = [[CkoMessageSet alloc] init];
success = [imap QueryMbx: criteria bUid: fetchUids msgSet: messageSet];
if (success == NO) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

//  Assuming we have 1 or more messages in the set, copy the 1st one to the folder "Inbox.testFolder"
if ([messageSet.Count intValue] > 0) {
    success = [imap Copy: [messageSet GetId: [NSNumber numberWithInt: 0]] bUid: messageSet.HasUids copyToMailbox: @"Inbox/testFolder"];
    if (success != YES) {
        NSLog(@"%@",imap.LastErrorText);
    }

}

NSLog(@"%@",imap.SessionLog);

NSLog(@"%@",@"OK");

//  Sample sessiong log:

//  ----INFO----
//  Connecting to IMAP server at outlook.office365.com:993
//  ----IMAP RESPONSE----
//  * OK The Microsoft Exchange IMAP4 service is ready. [QgBMADAAUABSADAAMQAwADIAQwBBADAAMAA3ADAALgBwAHIAbwBkAC4AZQB4AGMAaABhAG4AZwBlAGwAYQBiAHMALgBjAG8AbQA=]
//  ----IMAP REQUEST----
//  aaab LOGIN "chilkat@live.com"
//  ----IMAP RESPONSE----
//  aaab OK LOGIN completed.
//  ----IMAP REQUEST----
//  aaac SELECT "Inbox"
//  ----IMAP RESPONSE----
//  * 28 EXISTS
//  * 0 RECENT
//  * FLAGS (\Seen \Answered \Flagged \Deleted \Draft $MDNSent)
//  * OK [PERMANENTFLAGS (\Seen \Answered \Flagged \Deleted \Draft $MDNSent)] Permanent flags
//  * OK [UNSEEN 23] Is the first unseen message
//  * OK [UIDVALIDITY 14] UIDVALIDITY value
//  * OK [UIDNEXT 6416] The next unique identifier value
//  aaac OK [READ-WRITE] SELECT completed.
//  ----IMAP REQUEST----
//  aaad UID SEARCH SUBJECT "Test email"
//  ----IMAP RESPONSE----
//  * SEARCH 6414
//  aaad OK SEARCH completed.
//  ----IMAP REQUEST----
//  aaae UID COPY 6414 "Inbox/testFolder"
//  ----IMAP RESPONSE----
//  aaae OK [COPYUID 180 6414 1] COPY completed.
//  
//  OK