(Chilkat2-Python) Upload (Append) Email to an IMAP Mailbox and get the UID of the Appended Email

Upload / append an email to an IMAP mailbox and get the UID of the appended email.

Chilkat2 Python Downloads install with pip pip3 install chilkat2 or download... Python Module for Windows, Linux, Alpine Linux, MacOS, Solaris

import sys
import chilkat2

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

imap = chilkat2.Imap()

# Connect to an IMAP server.
# Use TLS
imap.Ssl = True
imap.Port = 993
success = imap.Connect("imap.someMailServer.com")
if (success != True):
    print(imap.LastErrorText)
    sys.exit()

# Login
success = imap.Login("myLogin","myPassword")
if (success != True):
    print(imap.LastErrorText)
    sys.exit()

# Check the capabilities of the IMAP server.
cap = imap.Capability()
print("IMAP capabilities: " + cap)

# If the capabilities string contains the substring "UIDPLUS", then 
# the UID of the appended email will be available in the AppendUid property (see below).

# For example, the GMail IMAP server has these capabilities (at this current time)
# * CAPABILITY IMAP4rev1 UNSELECT IDLE NAMESPACE QUOTA ID XLIST CHILDREN 
# X-GM-EXT-1 UIDPLUS COMPRESS=DEFLATE ENABLE MOVE CONDSTORE ESEARCH UTF8=ACCEPT 
# APPENDLIMIT=35882577 LIST-EXTENDED LIST-STATUS

email = chilkat2.Email()

# Load the email from a .eml file.
success = email.LoadEml("myEmail.eml")
if (success != True):
    print(email.LastErrorText)
    sys.exit()

success = imap.AppendMail("Inbox",email)
if (success != True):
    print(imap.LastErrorText)
    sys.exit()

# If the IMAP server supports the UIDPLUS extension, then the 
# imap.AppendUid will contain the UID of the appended email.
# Otherwise AppendUid will be 0.
print("UID of appended email: " + str(imap.AppendUid))

# If the IMAP server does NOT have UIDPLUS, then a program can 
# first select the mailbox, get the value of the UidNext property,
# and then append.  The appended email SHOULD have a UID equal to 
# the UidNext that was obtained just prior to appending (assuming no other
# program is simultaneously appending an email to the same mailbox).

# Note: It is not required to select a mailbox to append.  The select is only
# done for the purpose of obtaining the UIDNEXT value.
success = imap.SelectMailbox("Inbox")
if (success != True):
    print(imap.LastErrorText)
    sys.exit()

uidNext = imap.UidNext

success = imap.AppendMail("Inbox",email)
if (success != True):
    print(imap.LastErrorText)
    sys.exit()

print("The UID of the appended email SHOULD be " + str(uidNext))

print("Email uploaded to Inbox!")

# Disconnect from the IMAP server.
success = imap.Disconnect()