Skip to content

Commit

Permalink
Docs: clarify use of Mailgun's inbound "raw MIME" option
Browse files Browse the repository at this point in the history
Refs #389
  • Loading branch information
medmunds committed Aug 7, 2024
1 parent 7779920 commit 9d4fb5d
Showing 1 changed file with 10 additions and 7 deletions.
17 changes: 10 additions & 7 deletions docs/esps/mailgun.rst
Original file line number Diff line number Diff line change
Expand Up @@ -556,16 +556,19 @@ forwarding url) with Mailgun inbound routing.

.. note::

Anymail also supports Mailgun's "fully-parsed" inbound message format, but the "raw MIME"
version is preferred to get the most accurate representation of any received email.
Using raw MIME also avoids a limitation in Django's :mimetype:`multipart/form-data` handling
that can strip attachments with certain filenames (and inline images without filenames).
Anymail supports both of Mailgun's "fully-parsed" and "raw MIME" inbound
message formats. The raw MIME version is preferred to get the most accurate
representation of any received email. Using raw MIME also avoids a limitation
in Django's :mimetype:`multipart/form-data` handling that can strip attachments
with certain filenames (and inline images without filenames).

To use Mailgun's fully-parsed format, change :samp:`.../inbound_mime/` to just
:samp:`.../inbound/` at the end of the route forwarding url.
* To use raw MIME (recommended), the route forwarding url should end with
:samp:`…/inbound_mime/` as shown above.
* To use fully-parsed format (not recommended), omit the :samp:`_mime` so
the route forwarding url ends with just :samp:`…/inbound/`.

.. versionchanged:: 8.6
Using Mailgun's full-parsed (not raw MIME) inbound message format is no longer recommended.
Using Mailgun's fully-parsed inbound message format is no longer recommended.


.. _Receiving, Forwarding and Storing Messages:
Expand Down

0 comments on commit 9d4fb5d

Please sign in to comment.