Current Location: (South Africa only).

FTP and ASCII file:

FTP API file formats

Two file formats are supported:

1. Comma Delimited With Quotes (Required Fields in Bold):

Line 1: “UserName”,”Password”,”202302241900”

Line 2: “CellNumber”,”Message”,”RecipientFirstName”,”RecipientSurname”

Line 3: “CellNumber”,”Message”,”RecipientFirstName”,”RecipientSurname”

Line 4: CellNumber”,”Message”,”RecipientFirstName”,”RecipientSurname


2. Comma Delimited Without Quotes (Required Fields in Bold):

Line 1: UserName,Password,202302241900

Line 2: CellNumber,Message,RecipientFirstName,RecipientSurname

Line 3: CellNumber,Message,RecipientFirstName,RecipientSurname

Line 4: CellNumber,Message,RecipientFirstName,RecipientSurname



Do not include line numbers.

An FTP access account must first be requested and set up on the gateway in order to gain access to FTP root directory.

If using the file format Comma Delimited WITHOUT Quotes, be sure not to include any commas in the body of the Message field.

To schedule the batch for later delivery, include the date/time (GMT+2) on the first line.





This batch will be scheduled for 19H00 on 24 February 2023.

NB. Any individual messages longer than 918 characters will be truncated to 918 characters.

You will not be notified of this truncation.

This is because large FTP files could contain thousands of messages that are too long, and a notification for each message would be impractical. Please ensure that each individual message in the file is no longer than 918 characters (taking into account the symbols that count as 2 characters. For more information on symbols that count as 2 characters, click here.)

Don't have a WinSMS account yet? Register your free trial account here.

    • Related Articles

    • WinSMS API documentation & samples

      Developers have full access to the WinSMS API - tools which allow you to easily integrate 2-way SMS messaging into your existing database applications, custom software and web sites. If you are looking for information on how to use Email to SMS ...
    • How to get your WinSMS API key

      To get your WinSMS API key, follow the following instructions: Login to the WinSMS Client Zone here and login with your WinSMS username and password. Once logged in, click on "My Profile" Click on the "Developers" tab You can copy your API key from ...

      A REST API (Representational State Transfer) is an application program interface (API) that mainly uses the HTTP protocol requests to GET, PUT, POST and DELETE data from a program to a responsive web service. An SMS REST API is the easiest way for ...