Supported Mailbox Types¶
Django Mailbox supports polling both common internet mailboxes like POP3 and IMAP as well as local file-based mailboxes.
||Can also specify SSL with
||Can also specify SSL with
||Uses OAuth authentication for Gmail’s IMAP transport. See Gmail IMAP with Oauth2 authentication for details.|
|Piped Mail||empty||See Receiving mail directly from Exim4 or Postfix via a pipe|
Unless you are using IMAP’s ‘Archive’ feature, this will delete any messages it can find in the inbox you specify; do not use an e-mail inbox that you would like to share between applications.
POP3 and IMAP Mailboxes¶
Mailbox URIs are in the normal URI format:
Basic IMAP Example:
Basic POP3 Example:
Most mailboxes these days are SSL-enabled;
if yours use plain SSL add
+ssl to the protocol section of your URI,
but for STARTTLS add
Also, if your username or password include any non-ascii characters,
they should be URL-encoded (for example, if your username includes an
@, it should be changed to
%40 in your URI).
For a verbose example, if you have an account named
firstname.lastname@example.org with a password
1234 on GMail, which uses a IMAP server of
SSL) and you would like to fetch new emails from folder named Myfolder and archive them after processing
into a folder named
would enter the following as your URI:
Additional IMAP Mailbox Features¶
If you are using an IMAP Mailbox, you have two additional configuration options that you can set by appending parameters to the end of your mailbox URI.
Specifying the source folder¶
Although by default, Django Mailbox will consume messages from your ‘INBOX’
folder, you can specify the folder from which you’d like messages consumed
by specifying the
folder URI query parameter; for example, to instead
consume from the folder named ‘MyFolder’, you could add
to the end of your URI:
Specifying an archive folder¶
Django Mailbox will delete messages immediately after processing them, but you can specify an IMAP folder to which the messages should be copied before the original message is deleted.
To archive email messages, add the archive folder
name as a query parameter to the URI. For example, if your mailbox has a
myarchivefolder that you would like to copy messages to
after processing, add
?archive=myarchivefolder to the end of the URI:
Gmail IMAP with Oauth2 authentication¶
The Gmail Mailbox is also a regular IMAP mailbox, but the password you specify will be ignored if OAuth2 authentication succeeds. It will fall back to use your specified password as needed.
Build your URI accordingly:
Local File-based Mailboxes¶
If you happen to want to consume a file-based mailbox like an Maildir, Mbox,
Babyl, MH, or MMDF mailbox, you can use this too by entering the appropriate
‘protocol’ in the URI. If you had a maildir, for example, at
you would enter a URI like:
Note that there is an additional
/ in the above URI after the protocol;
this is important.