Send Message

Send an SMS or MMS message.

Send an SMS or MMS message to a recipient. In its simplest use, you can use the to, fonenumber and message fields to send a basic text message. FoneStorm will respond with an id for the message that can be used to retrieve further information on status and delivery.

{
  "message": {
    "id": "57a18ecef58ccca2bcfaee3a4248a3cf"
  }
}

🚧

Networks impose a limit of one message per second per sending (from) number. Calls that exceed this rate limit will receive an error code of 400 - Rate Limit Exceeded.

Notes

media

Binaries, as identified by media, have a size limit of 15MB. Parameter media can accept a file or a URL of the file.

Supported MMS File Types

ExtensionFile Type-ExtensionFile Type-ExtensionFile Type-ExtensionFile Type
.gzapplication/gzip.flacaudio/flac.jpgimage/jpeg.avivideo/avi
.jsapplication/javascript.m4aaudio/mp4.pjpegimage/pjpeg.m4vvideo/mp4
.jsonapplication/json.m4baudio/mp4.pngimage/png.mp4video/mp4
.ogaapplication/ogg.m4paudio/mp4.svgimage/svg+xml.m1vvideo/mpeg
.oggapplication/ogg.m4raudio/mp4.tifimage/tiff.mpegvideo/mpeg
.ogvapplication/ogg.m1aaudio/mpeg.tiffimage/tiff.mpgvideo/mpeg
.ogxapplication/ogg.m2aaudio/mpeg.webpimage/webp.mpvvideo/mpeg
.pdfapplication/pdf.mp1audio/mpeg.icoimage/x-icon.oggvideo/ogg
.rtfapplication/rtf.mp2audio/mpeg.caltext/calendar.ogmvideo/ogg
.smilapplication/smil.mp3audio/mpeg.csstext/css.ogvvideo/ogg
.bz2application/x-bzip2.mpaaudio/mpeg.csvtext/csv.ogxvideo/ogg
.gzapplication/x-gzip.ogaaudio/ogg.htmltext/html.spxvideo/ogg
.tarapplication/x-tar.wavaudio/wav.jstext/javascript.movvideo/quicktime
.xmlapplication/xml.webmaudio/webm.txttext/plain.qtvideo/quicktime
.zipapplication/zip.bmpimage/bmp.vcardtext/vcard.webmvideo/webm
.3gpaudio/3gpp.dibimage/bmp.vcftext/vcard.flvvideo/x-flv
.3gaaudio/amr.gifimage/gif.waptext/vnd.wap.wml.wmvvideo/x-ms-wmv
.amraudio/amr.jpegimage/jpeg.xmltext/xml

confirmation_url

Message sending confirmation callback URLs receive JSON data via a POST request (see below for a description of the data package) but can also use token replacements to receive callback data values in query string parameters. For more information, see Callbacks / Web Hooks.

ParameterTypeDescription
tostringPhone number of recipient.
fromstringFoneNumber of sender.
msgstringContents of the message.
dsstringDelivery state of the message. Potential values are waiting, delivered or not-delivered.
dcintDelivery code of the message. Potential values are:
  • 000 - Message delivered to carrier
  • 100 - Message not delivered to carrier
  • 187 - Statistical spam detected
  • 188 - Keyword spam detected
  • 189 - Spam detected
  • 482 - Loop detected
  • 600 - Destination carrier could not accept messages
  • 610 - Message submission failed
  • 620 - Destination application error
  • 630 - Message not acknowledged
  • 720 - Invalid destination number
  • 740 - Invalid source number
  • 999 - Unknown error
idstringUnique identifier for the message.

🚧

Sending messages may result in additional charges and fees to your account.

Language
Authentication
Header
Response
Click Try It! to start a request and see the response here!