Messaging API: How do I send a text message longer than 250 characters?

Last Updated: Sep 06, 2017 09:25AM PDT
The Zipwhip Messaging API has two message send calls/commands that you can use to send text messages:
  • Message/send is the call/command that sends standard text-only (SMS) messages. You can include a maximum of 250 bytes in the message body (payload). This means that if you send a message that includes only characters found in GSM 03.38, then you can include 250 characters. If you use any characters outside this character set, then you may be limited to 125 characters.
  • Messaging/send is the call/command that sends a text message with a “media” attachment (MMS). You can include a maximum of 700 bytes in the message body (payload). This means that you can include 700 characters from the GSM 03.38 characters set in your message.

You can also attach a file to an MMS message. The maximum file size allowed for attachments is 800 kb. You can attach any of the following file types:
  • image/bmp
  • image/gif
  • image/jpeg
  • image/png
  • text/plain

If you want to send a block of text longer than 700 characters, then you can attach a text (.txt) file to your MMS message. The maximum size of the text file that you can attach is 600 kb, which is approximately 600,000 characters.


The following is an example of sending a text file as an attachment to an MMS message:
$ curl –X POST \
       –F"file=@longmessage.txt" \"?"session=[sessionKey]"&"

Customer Care
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
Invalid characters found