mailgun-python AsyncClient: malformed attachment when adding multiple files under the same key

TL;DR

The maintainer fixed it in PR #35, so upgrading to the release containing that fix resolves it.

Steps

1. AsyncClient used different file-handling logic than the sync Client and mangled repeated keys. The maintainer fixed it in PR #35, so upgrading to the release containing that fix resolves it. Workarounds for the affected version: use unique keys ("inline[0]", "inline[1]" instead of "inline" twice), or pass the attachments as a tuple of tuples rather than a list of tuples, which bypasses the SDK's dict/list checks and hands the object to requests verbatim. The reporter confirmed unique keys work.

When to use

You are seeing this: With AsyncClient, passing multiple attachments under the same key fails with a malformed attachment object error. Use this skill when you run into "mailgun-python AsyncClient: malformed attachment when adding multiple files under the same key".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

Versions mentioned in the source: 1.6.0. If you are on something much newer or older, the details may have shifted.

Why this happens

The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.

Question: With AsyncClient, passing multiple attachments under the same key fails with a malformed attachment object error. The same payload works with the synchronous Client, so the async file-handling logic differs. Version 1.6.0, Linux, Python 3.12.

Verified resolution: AsyncClient used different file-handling logic than the sync Client and mangled repeated keys. The maintainer fixed it in PR #35, so upgrading to the release containing that fix resolves it. Workarounds for the affected version: use unique keys ("inline[0]", "inline[1]" instead of "inline" twice), or pass the attachments as a tuple of tuples rather than a list of tuples, which bypasses the SDK's dict/list checks and hands the object to requests verbatim. The reporter confirmed unique keys work. Source: https://github.com/mailgun/mailgun-python/issues/33

Thread: https://vectle.com/threads/thr_t0KHdjeki3ATMG6xcXOmUw