Email hooks – iceScrum

Obsolete iceScrum documention (R6#14+) This documentation applies only to old iceScrum R6. For new iceScrum v7, click here.

You may have an idea to submit to iceScrum while you have no access to the tool. You can now send an email to a specific email address bound the your iceScrum server in order to suggest a story in the sandbox or create an urgent task in the current sprint.


You will need to configure iceScrum by giving information about your email server and the email account on which iceScrum will listen to incoming emails.

Supported email protocols are imap and pop, both in insecure and secure forms. The connection to the server host will be done through the default port corresponding to the protocol you defined.

Specific settings:
Mail protocol: enter pop3 or imap for insecure connection and pop3s or imaps for secure connection.
Settings: enter transport = YOURPROTOCOL, YOURPROTOCOL being the protocol defined in the protocol field.
You can test the connection to the server thanks to the “test” button.

Please note that iceScrum will listen to emails received in the “inbox” folder only.


Once email hooks are configured, you should be able to create tasks and stories in iceScrum by sending emails to the configured account.

To do so, the email subject must begins with a particular template that indicates:
– The target project key PROJECTKEY
– The TYPE of the element you want to create: STORY or TASK

Here is the subject template format: [PROJECTKEY-TYPE]. The subject text following this template will become the task/story name, while your mail body will become the task/story description.

Please note that for security reasons, the corresponding task/story will be created only if the email address you send the mail from is associated with an iceScrum user having sufficient rights (same rights as required in the user interface).

You should receive a confirmation or error email so you can get feedback on your story/task creation.

Try it for free now
All you need for your Agile project management