Send basic message
Note: This page requires that you are familiar with the Unicode messages.
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 (that contains 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.
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 overview page.
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_FLASHtext: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:1text:005400680069007300200069007300200061002000730061006d0070006c00650020006d006500730073006100670065002000730065006e007400200061007300200055006e00690063006f0064006500200064006100740061002e |
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:3from:<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 sampletext:message that gets displayedtext:on multiple lines ontext:the handset |
The SMS will be displayed on the handset as:
This is a samplemessage that gets displayedon multiple lines onthe handset |
How NOT to send a message
api_id:xxxxuser:xxxxpassword:xxxxto:xxxxtext: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 isnot next to the text: parameter.ID: 799e4150adfcd8f02c512afc69f28bf1 To:3456789012ID: 8e652dcd3e0ac225966a34312e01bc58 To:4567890123 |
Submit a Comment
Other Resources
Ask the Community
Visit Stack Overflow to join our community of developers and find the answer you need
Contact Support
Contact our support team and one of our agents will be in touch with you to answer any questions you have