Incoming Mail Handler

When setting up a mail handler, if I leave the "Folder Name" field blank, so that JIRA will pull mail out of my Inbox, the Test Run works fine.

If I change the "Folder Name" field to the name of a folder which already existed before today, like "Deleted Items", the Test Run works fine.

If I change the Incoming Mail MAPI server settings to a different user who already had a folder named "SRTDev"on our Exchange server (before today) and change the "Folder Name" field to "SRTDev", the Test Run works fine.

If I connect to my email account and change the "Folder Name" field to the name of a folder which I just created today, the Test Run does not work. I get the following error:

" Messaging Exception in service '$MessageProviderImpl' when getting mail: SRTDev not found: SRTDev not found "

Do I just need to wait till tomorrow? Is this happening because I just added this folder and something hasn't synced with the Exchange server yet?

6 answers

1 accepted

My folder was a sub-folder of my Inbox, so not only did I need a slash in the Folder entry, but Inbox had to be all uppercase, like so: INBOX/SRTDev

In addition, IMAP doesn't like slashes (/) within mailbox folder names, so JIRA will not be able to retrieve mail from a folder named "SRT/LPR".

I just had the same issue. In stead of using slashes, use a dot. I.e.:


Then it suddenly works. Would be nice if Atlassian would add it to their guide:

Abel, do you mean that one may have a slash (/) in a folder name if one is using dots (.) in the path?

1 votes
Renjith Pillai Community Champion Feb 15, 2013

May be you should ask you Exchange administrators.

How about deleting and recreating the mail handler in JIRA. Just suspecting if there is some cache which holds the IMAP folder structure which is never reloaded once a handler is created.

Thank you, now it works!!!

Thanks, Renjith, but apparently I just needed to give it a day or two for my new Outlook folder to appear on the Exchange server. I'm not sure how long it took, but I was out of the office for 3 days.

It's working now. :)

I mean that if you want to specify a subfolder, the typical way would be to use a slash. However, when configuring the mail handler in Atlassian Jira, you should use a dot instead. So, if your subfolder is called JiraMail, directly under the Inbox root, you should specify it as INBOX.JiraMail inside the mail handler (not INBOX/JiraMail or INBOX\JiraMail or just JiraMail).

If you have a deeper nested structure in your IMAP mail system, say Bugs, Features under the folder JiraMail, you can use INBOX.JiraMail.Bugs and INBOX.JiraMail.Features.

Okay. Thanks, Abel. :)

it worked on my side without entering the "INBOX" just the path where the emails are

is spcifying folder option not available in JIRA on-demand version?

Suggest an answer

Log in or Join to answer
Community showcase
Sarah Schuster
Posted Jan 29, 2018 in Jira

What are common themes you've seen across successful & failed Jira Software implementations?

Hey everyone! My name is Sarah Schuster, and I'm a Customer Success Manager in Atlassian specializing in Jira Software Cloud. Over the next few weeks I will be posting discussion topics (8 total) to ...

3,110 views 13 19
Join discussion

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you
Atlassian Team Tour

Join us on the Team Tour

We're bringing product updates and pro tips on teamwork to ten cities around the world.

Save your spot