Key Takeaways
- MMS on an Android gateway is the phone’s MMS stack plus the operator’s MMSC — not a cloud image CDN we run.
- Most “attachment failed” tickets are size, APN, data, or a Wi-Fi-only tablet — not the REST envelope.
- Fall back to SMS with a hosted image URL when the SIM cannot complete MMS. Do not retry a 2MB JPEG forever.
- OTP must never share a radio with bulk picture sends.
- Developer Center owns live attachment fields. This page is failure modes.
- BYO phone and operator credit. We meter devices and send volume.
Summary
MMS attachments on an Android SMS gateway fail in the phone and the operator, not in a mysterious cloud image farm. You still bring the Android handset and the SIM that can send MMS. Platform pricing is devices plus send volume. This page is the troubleshooting spoke — match MMS gateway for the product shape. Confirm live fields in the Developer Center.
If the handset cannot open the carrier’s MMSC on mobile data, no JSON retry budget will attach the picture.
What actually fails
Search intent is “MMS not sending from the Android gateway.” Typical causes: payload over the operator size ceiling, Wi-Fi-only tablet, APN without MMS proxy, OEM killing background data, empty prepaid data bundle, or a JPEG that never got resized. GSMA-oriented MMS is a family of operator implementations — GSMA— not one global max bytes we can promise.
Context
Retail receipts, field photos, ticket screenshots. Radio reality: MMS needs data, not just SMSC. Related: failed MMS troubleshooting.
How to diagnose
- Same file, native Messages app, same SIM. If native fails, stop blaming the API.
- Resize under a conservative cap (many operators sit well below 1MB). Retry once.
- Confirm mobile data, MMS APN, last-seen, OEM exemptions.
- Log gateway id; do not treat HTTP 202 as recipient saw the image.
- If MMS is optional, SMS + your HTTPS image URL.
Check table
| Symptom | Likely cause | First move |
|---|---|---|
| Accept, never arrives | MMSC / APN / data | Native Messages test |
| Immediate reject | Size / type | Resize, JPEG, drop video |
| Tablet only | No SMS/MMS radio | Use a phone SIM |
| Works on Wi-Fi SMS, fails MMS | MMS needs operator data | Disable Wi-Fi-only APN myth |
| OTP delayed | Shared radio with pictures | Isolate devices |
MMS airtime vs SMS
Operators often bill MMS differently from SMS. That bill is yours. Platform: devices + volume. Free is 300 SMS lifetime — not a picture-blast budget. See pricing.
Operations
Pair setup. Keep a known-good 200KB JPEG as a canary. Photograph APN screens. Do not dump a catalog of product shots through one SIM at dinner rush.
Attachment hygiene
IDs and faces in images are personal data. Redact before tickets. Do not log binary bodies. Keys stay on servers.
When to fall back to SMS
Fall back when native MMS fails, recipients are on prepaid data-off, or you only need a link. Keep MMS when the operator path is proven and the file is small.
Checklist
- Native Messages canary.
- Size under cap.
- MMS APN + data.
- Phone, not Wi-Fi tablet.
- OTP isolated.
- Official APK.
- Developer Center fields.
- Fallback URL owned by you.
- Airtime owner.
- No unlimited MMS titles in runbooks.
Next steps
Feature MMS, image-size mindset size limits, downloads APK.
Deep dive: production hardening
Freeze a resize pipeline. Re-canary after SIM swaps and OEM updates. Keep last-seen SLOs even when the payload is a picture.
Deep dive: scaling and failure modes
Scale with devices, not a louder JPEG. Failures: oversized files, Doze, empty data, shared OTP radio. Starter, Professional, and Business list Unlimited SMS as platform send volume; that is not unmetered carrier SMS.
Deep dive: integration discipline
Persist gateway ids. Idempotent jobs. Replay-safe webhooks. Developer Center owns schemas. You bring the Android phone and operator SMS (and MMS) credit.
Related product pages
Jump to the live product docs for this topic—not another long-form article.
- MMS gateway on your own SIMMultimedia where supported
- SMS API documentationLive endpoint reference
- device and SMS volume pricingPlans and allowances
- Android SMS gateway product guideDefinition, product, and how to buy
