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:

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 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.


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.


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.


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.


If you have any questions, get in touch with our support.