Thank you for filling out the form. One of our mobile experts will be in touch shortly to discuss your inquiry.
If you have any other questions please feel free to email us directly at firstname.lastname@example.org
Mitto’s SMS API lets you send secure, reliable SMS messages. The service is available to MITTO clients. With this API you can:
We organize our documentation as follows:
This section describes how to get started with Mitto’s SMS API. After reading this, you will know how to sign up with Mitto, what endpoints are available, and the request and response format for this API.
To get started with Mitto, do the following:
1. Sign up for a Mitto account at https://www.mitto.ch/contact/ or write to email@example.com.
2. Submit the IPs you want to use for requests. They must be whitelisted on Mitto’s system.
3. For callbacks, provide your dedicated callback URL and method (both GET and POST methods are supported). Alternatively, you can use dynamic callbacks. See Replace Callback URL in an API Call for more details. See Retrieve Delivery Reports for details about reports.
4. Mitto will respond with your API key and confirmation that your IP addresses and callback URL are configured.
To send a message, make a POST request to this endpoint:
The rest of the message-related information (like recipient’s MSISDN, text of the message, etc.) and sending options (like the character set encoding) you pass as body parameters.
By default, Mitto returns JSON. If you want to receive the response in XML, then change the URL of the POST request to:
The JSON representation of the request body schema for the mandatory parameters only looks like:
The JSON representation of the full request body schema (mandatory + optional parameters) looks like:
The required headers are:
For examples of API calls, refer to the SMS Use Cases section.
Mitto returns the response in JSON data format by default, but the format can be JSON or XML. The response contains information about the delivery status of the SMS, a timestamp for the delivery, and a message ID. Additionally, if you used optional request parameters in the call, the response includes them. The typical response payload (when the call was made with the mandatory request parameters only) looks like this:
"ids": [ "715118ef01aa4480bbd67324a0459b0b" ],
"responseText": "SMS sent successfully."
Mitto’s SMS API requires authentication on every request. To authenticate, you pass your API key in the header of the request like this:
In addition to authenticating on every request, you must also have the IP from which the requests are made whitelisted on MITTO’s system. Mitto enforces this additional security measure for your protection. To see an implementation of an API call with authentication, refer to the SMS Use Cases section.