Send basic message

This page requires that you are familiar with theunicode messages. Using the FTP API page.

Clickatell FTP server: ftpupload.clickatell.com

Check your log file

To ensure that your uploaded text file has been processed/accepted, it is important that you view the log file (which contain API responses). Read about the FTP API log file here.


Sending unique messages to each handset using one file

To send a unique/personalized SMS message to each handset (using one text file), please view the template based messaging page for this API.


Adding new lines to an SMS message

If you wish to insert new lines/line breaks into your SMS message, you can do so by using multiple text parameters. Please note that line breaks (new lines) use two character spaces.

send basic message code


Basic parameters

Parameter

Required

Description

api_id

Yes

Your API ID

user

Yes

Your API username

password

Yes

Your API password

to

Yes

The mobile number to which the message must be delivered. The number should be in international number format (no leading zeros or + symbol should be used).

text

Yes

The text content of the message. Note that some characters take up two character spaces because of GSM encoding standards.

Many more parameters are available and listed on the parameter overviewpage.


Examples:

Basic message

api_id:<place API ID here>
user:<place username here>
password:<place password here>
text:This is my message being sent to 3 mobile numbers.
to:<place recipient number here>
to:<place recipient number here>
to:<place recipient number here>

Flash message

api_id:<place API ID here>
user:<place username here>
password:<place password here>
to:<place recipient number here>
msg_type:SMS_FLASH
text:This is my flash message that will be delivered to the above specified mobile number!

Unicode message

api_id:<place API ID here>
user:<place username here>
password:<place password here>
to:<place recipient number here>
unicode:1
text:005400680069007300200069007300200061002000730061006d0070006c00650020006
d006500730073006100670065002000730065006e007400200061007300200055006e00690063006f0064006500200064006100740061002e

Use callback and sender ID

api_id:<place API ID here>
user:<place username here>
password:<place password here>
to:<place recipient number here>
callback:3
from:<place your mobile number here>
text:This is my flash message that will be delivered to the above specified mobile number!

Single recipient, multiline message

api_id:<place API ID here>
user:<place username here>
password:<place password here>
to:<place recipient number here>
text:This is a sample
text:message that gets displayed
text:on multiple lines on
text:the handset

The SMS will be displayed on the handset as:

This is a sample
message that gets displayed
on multiple lines on
the handset

How to NOT send a message

api_id:xxxx
user:xxxx
password:xxxx
to:xxxx
text:Any text not next to the text parameter will not be delivered.
These last 2 lines will not be part of the delivered message because it is
not next to the text: parameter.
ID: 799e4150adfcd8f02c512afc69f28bf1 To:3456789012
ID: 8e652dcd3e0ac225966a34312e01bc58 To:4567890123