summaryrefslogtreecommitdiff
path: root/doc/mailgun.markdown
diff options
context:
space:
mode:
Diffstat (limited to 'doc/mailgun.markdown')
-rw-r--r--doc/mailgun.markdown28
1 files changed, 28 insertions, 0 deletions
diff --git a/doc/mailgun.markdown b/doc/mailgun.markdown
new file mode 100644
index 00000000..6465903a
--- /dev/null
+++ b/doc/mailgun.markdown
@@ -0,0 +1,28 @@
+Mailgun
+=======
+
+You can use the service [Mailgun](http://www.mailgun.com/) to create tasks directly by email.
+
+This integration works with the inbound email service of Mailgun (routes).
+Kanboard use a webhook to handle incoming emails.
+
+The [incoming email workflow is described here](create-tasks-by-email.markdown).
+
+Mailgun configuration
+---------------------
+
+Create a new route in the web interface or via the API ([official documentation](https://documentation.mailgun.com/user_manual.html#routes)), here an example:
+
+```
+match_recipient("^kanboard\+(.*)@mydomain.tld$")
+forward("https://mykanboard/?controller=webhook&action=mailgun&token=mytoken")
+```
+
+The Kanboard webhook url is displayed in **Settings > Integrations > Mailgun**
+
+Kanboard configuration
+----------------------
+
+1. Be sure that your users have an email address in their profiles
+2. Assign a project identifier to the desired projects: **Project settings > Edit**
+3. Try to send an email to your project