Messaging
Send images, GIFs, and media that renders everywhere
Same endpoint as SMS, one extra field. We transcode and resize to what each carrier accepts, so a receipt image looks right on an eight-year-old handset and on the latest flagship.
01
Transcoding handled upstream
Upload a 4 MB PNG and we deliver a carrier-safe file. No pre-processing pipeline to build, no per-carrier size table to maintain.
02
Multiple attachments
Up to 10 media items per message, mixed with text, delivered as a single MMS on carriers that support it.
03
Inbound media
Media your customers send back is stored on a signed, expiring URL and delivered through the same inbound webhook as SMS.
04
Graceful SMS fallback
If a destination cannot receive MMS, we can fall back to SMS with a link instead of silently failing. You choose the behavior per message.
Send your first message
Authentication is a key pair over HTTPS basic auth. There is no SDK requirement — every endpoint is plain REST.
curl https://api.anthonyoliva.com/v1/messages \
-u "$AO_KEY_ID:$AO_KEY_SECRET" \
-H "Content-Type: application/json" \
-d '{
"from": "+13155550142",
"to": "+13155550188",
"body": "Your technician has arrived. Photo attached.",
"media_urls": ["https://cdn.example.com/arrival.jpg"],
"campaign_id": "C7X4M2P"
}'Specifications
- Formats
- JPEG, PNG, GIF, MP4, PDF, vCard
- Max size
- 5 MB after transcoding, 10 MB on upload
- Attachments
- Up to 10 per message
- Text with media
- Up to 1,600 characters
- Number types
- 10DLC local, toll-free
- Inbound media retention
- 30 days, configurable
Common use cases
- Appointment cards and boarding passes
- Photo confirmation of a delivery or a repair
- Receipts, invoices, and statements
- Product imagery in a consented marketing program
- Proof-of-service documentation in field operations
Consent still comes first
Every use case above assumes the recipient gave you prior express consent for that specific program. Our Messaging Policy sets out exactly what your call-to-action must disclose and how long you have to keep the proof.
Talk to someone who has read the carrier rules
Tell us what you are sending, to whom, and how they consented. We will tell you honestly whether it will get approved, and what to change if it will not.