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

🚧
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 410 - 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

Extension	File Type	Extension	File Type	Extension	File Type	Extension	File Type
.gz	application/gzip	.flac	audio/flac	.jpg	image/jpeg	.avi	video/avi
.js	application/javascript	.m4a	audio/mp4	.pjpeg	image/pjpeg	.m4v	video/mp4
.json	application/json	.m4b	audio/mp4	.png	image/png	.mp4	video/mp4
.oga	application/ogg	.m4p	audio/mp4	.svg	image/svg+xml	.m1v	video/mpeg
.ogg	application/ogg	.m4r	audio/mp4	.tif	image/tiff	.mpeg	video/mpeg
.ogv	application/ogg	.m1a	audio/mpeg	.tiff	image/tiff	.mpg	video/mpeg
.ogx	application/ogg	.m2a	audio/mpeg	.webp	image/webp	.mpv	video/mpeg
.pdf	application/pdf	.mp1	audio/mpeg	.ico	image/x-icon	.ogg	video/ogg
.rtf	application/rtf	.mp2	audio/mpeg	.cal	text/calendar	.ogm	video/ogg
.smil	application/smil	.mp3	audio/mpeg	.css	text/css	.ogv	video/ogg
.bz2	application/x-bzip2	.mpa	audio/mpeg	.csv	text/csv	.ogx	video/ogg
.gz	application/x-gzip	.oga	audio/ogg	.html	text/html	.spx	video/ogg
.tar	application/x-tar	.wav	audio/wav	.js	text/javascript	.mov	video/quicktime
.xml	application/xml	.webm	audio/webm	.txt	text/plain	.qt	video/quicktime
.zip	application/zip	.bmp	image/bmp	.vcard	text/vcard	.webm	video/webm
.3gp	audio/3gpp	.dib	image/bmp	.vcf	text/vcard	.flv	video/x-flv
.3ga	audio/amr	.gif	image/gif	.wap	text/vnd.wap.wml	.wmv	video/x-ms-wmv
.amr	audio/amr	.jpeg	image/jpeg	.xml	text/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.

Parameter	Type	Description
`to`	string	Phone number of recipient.
`from`	string	FoneNumber of sender.
`msg`	string	Contents of the message.
`ds`	string	Delivery state of the message. Potential values are `waiting`, `delivered` or `not-delivered`.
`dc`	int	Delivery 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
`id`	string	Unique identifier for the message.

Response Properties

Property	Type	Description
message	object	Message

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