Getting started
In order to use the MMS API, you need the following:
Basic request format
Sending an MMS is done with a simple POST request to the API. The request
must contain the parameters from, to, and at
least one of the parameters message or image.
The from parameter should be an MMS-enabled virtual phone
number, in the E.164 format. The to parameter should an the recipient's phone number, also in the E.164 format. message is an arbitrary text that will be displayed in the MMS.
The image parameter should be either:
- A publicly accessible URL pointing to an image file, or
- A Base64/url-encoded string containing representation of an image
Image formats
PNG and JPG image formats are supported by the API. There is no hard limit on the size of an image but the total payload size of the MMS (text + images or other media) cannot exceed 320kB.
MMS vs. SMS
MMS uses completely different protocols than SMS and some features of SMS are not part of the MMS standard, for example delivery reports, alphanumeric senders and multipart messages.
Pricing
MMS are billed at a flat rate per message, regardless of the payload size. Up-to-date prices can be found on our pricing page.
Coverage
MMS support is currently limited to 🇸🇪 Sweden but we're looking for beta-testers for other countries. If you're not in Sweden and are interested in trying out MMS, get in touch.
Throughput
Default maximum throughput is 100 SMS per minute per account. Additional messages will be queued and sent in-order. Contact support if you require additional throughput.
Help?
If you have any questions, get in touch with our support.
