Sample code for 30+ languages & platforms
Perl Requires Chilkat v11.0.0+

IMAP Copy Email from Selected Folder to Another Folder

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

Chilkat Perl Downloads

Chilkat2 Perl
use strict;
use warnings;
use Chilkat2;

# 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.
my $imap = Chilkat2::Imap->new;

# Turn on session logging for debugging.
$imap->KeepSessionLog(1);

# Connect using TLS.
$imap->Ssl(1);
$imap->Port(993);
my $success = $imap->Connect('imap.example.com');
if (!$success) {
    print $imap->LastErrorText, "\n";
    exit;
}

# Authenticate
$success = $imap->Login('email_account_login', 'email_account_password');
if (!$success) {
    print $imap->LastErrorText, "\n";
    exit;
}

# Select an IMAP mailbox
$success = $imap->SelectMailbox('Inbox');
if (!$success) {
    print $imap->LastErrorText, "\n";
    exit;
}

# Search for messages having "Test email" in the subject.
my $fetchUids = 1;
my $criteria = 'SUBJECT "Test email"';
my $messageSet = Chilkat2::MessageSet->new;
$success = $imap->QueryMbx($criteria, $fetchUids, $messageSet);
if (!$success) {
    print $imap->LastErrorText, "\n";
    exit;
}

# Assuming we have 1 or more messages in the set, copy the 1st one to the folder "Inbox.testFolder"
if ($messageSet->Count > 0) {
    $success = $imap->Copy($messageSet->GetId(0), $messageSet->HasUids, 'Inbox/testFolder');
    if (!$success) {
        print $imap->LastErrorText, "\n";
    }
}

print $imap->SessionLog, "\n";

print "OK\n";

# 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