SMS Text Messaging

An easy-peasy powerful set of API's for sending SMS text messages and many other actions.

It is the most feature-rich of our APIs and provides the most detailed information about the success/failure of your requests. Using a RESTful paradigm, our REST API uses standard Internet protocols, making it easily accessible from all programming languages.

It assumes the reader has a basic understanding of the principles of a RESTful API, as covered in our document A Beginners Guide to RESTful SMS Services, which is available from our web site.

Give it a try!

You will need to create an account to receive your API username and password, use promo code mashape and get 50 free SMS sends.

  1. ACCEPTANCE OF TERMS

Text Marketer Ltd provides its service to you, subject to the following Terms of Service ("TOS"), which may be updated by us from time to time without notice to you. You can review the most current version of the TOS at any time. In addition, when using particular Text Marketer services, you and Text Marketer shall be subject to any posted guidelines or rules applicable to such services that may be posted from time to time. All such guidelines or rules are hereby incorporated by reference into the TOS.

  1. DESCRIPTION OF SERVICE

Text Marketer provides users with access to a collection of resources, including, various communications tools and personalized content through its network of properties (the "Service"). Unless explicitly stated otherwise, any new features that augment or enhance the current Service, including the release of new Text Marketer properties, shall be subject to the TOS. Text Marketer currently provides users with the ability to forward SMS messages through its system. You understand that for the purposes of the TOS Text Marketer does not send an SMS message, or cause an SMS message to be sent, merely because Text Marketer provides a service that enables SMS messages to be sent. You understand and agree that the Service is provided "AS-IS" and that Text Marketer assumes no responsibility for the timeliness, deletion, mis-delivery or failure to store any user communications or personalisation settings. You are responsible for obtaining access to the Service and that access may involve third party fees (such as Internet service provider or airtime charges). You are responsible for those fees, including those fees associated with the display or delivery of advertisements. In addition, you must provide and are responsible for all equipment necessary to access the Service.

In the unlikely event that Text Marketer were to go into administration all Credits purchased will expire after 12 months from the time of purchase. Otherwise all Credits will remain indefinitely on all customers accounts.

  1. REGISTRATION

In consideration of your use of the Service, you agree to provide true, accurate, current and complete information about yourself as prompted by the Service's registration system (such information being the "Registration Data"). If you provide any information that is untrue, inaccurate, not current or incomplete, or Text Marketer has reasonable grounds to suspect that such information is untrue, inaccurate, not current or incomplete, Text Marketer has the right to suspend or terminate your account and refuse any and all current or future use of the Service (or any portion thereof).

If you are under the age of eighteen (18), Text Marketer requires you to gain permission to register and use the service from a parent or guardian. Should you be under eighteen (18) and these TOS are wrongfully accepted without a parent or guardians permission, it is taken that the TOS will still apply as would ordinary transactions, freely chose, in ordinary market conditions.

  1. USER CONDUCT

You understand that all information, data, text, software, music, sound, photographs, graphics, video, messages or other materials ("Content"), whether publicly posted or privately transmitted, are the sole responsibility of the person from which such Content originated. This means that you, and not Text Marketer, are entirely responsible for all Content that you upload, post, email, transmit or otherwise make available via the Service. Text Marketer does not control the Content posted via the Service and, as such, does not guarantee the accuracy, integrity or quality of such Content. Under no circumstances will Text Marketer be liable in any way for any Content, including, but not limited to, for any errors or omissions in any Content, or for any loss or damage of any kind incurred as a result of the use of any Content posted, transmitted or otherwise made available via the Service.

4.1. What you cannot use the Service for

You must not use the Service, attempt to use the Service or allow the Service to be used in any way:

4.1.1. Breach of law

(a) which results in you or Text Marketer breaching, or being involved in a breach of a law, order or regulation (including a foreign law, order or regulation), a mandatory code of conduct; or a voluntary code of conduct that you have agreed to comply with;

4.1.2. Damage to property or people

(a) which results, or could result, in damage to property or injury to any person;

(b) to harass, menace or stalk people;

(c) to defame or slander any person, or infringe upon any person's privacy rights;

4.1.3. Protection of minors

(a) which harms minors in anyway.

(b) which enables a minor to access material inappropriate for a minor or to establish (or try to establish) contact with a minor not otherwise known to you;

4.1.4. Discrimination

(a) which unlawfully incites discrimination, hate or violence towards one person or group, for example because of their race, religion, gender or nationality;

4.1.5. Obscene, defamatory, offensive, abusive

(a) to send, display or be otherwise involved in material which is harassing, libellous, defamatory, abusive, threatening, harmful, vulgar, obscene or otherwise objectionable material of any kind or nature;

(b) which is, or which would be considered by a reasonable person to be, offensive or abusive;

4.1.6. Illegal business practices and gambling

(a) to engage in any misleading or deceptive business or marketing practice;

(b) that involves providing or promoting illegal pyramid selling schemes or unlawful gambling or gaming activities;

(c) that you do not have a right to make available under any law or under contractual or fiduciary relationships (such as inside information, proprietary and confidential information learned or disclosed as part of employment relationships or under nondisclosure agreements);

(d) that infringes any patent, trademark, trade secret, copyright or other proprietary rights of any party;

(e) that intentionally or unintentionally violates any applicable local, state, federal or international law, including, but not limited to, regulations promulgated by the UK Government;

4.1.7. The rights of others

(a) which infringes Text Marketer or any other person's rights (including intellectual property rights and moral rights);

(b) "stalk" or otherwise harass any person.

(c) which constitutes a misuse of Text Marketer's or any other person's confidential information; or

(d) which results in a breach by you of any obligation that you owe to any person.

4.2. What you cannot use the service to do

You are not authorised to access Text Marketer's computer systems or networks for any purpose other than to use the Service in accordance with these TOS.

You must not:

4.2.1. Interfering with services and systems

(a) interfere with the proper operation of the Service or any other part of Text Marketer systems;

4.2.2. Newsgroups, forums and chatrooms

(a) use the Service to contribute to, or participate in, a Newsgroup, forum or chat room in a way that has an adverse effect on the proper operation of those Newsgroups, forums and chat rooms.

You must not use the Service, attempt to use the Service or allow the Service to be used:

4.2.3. Commercial Messages

(a) to send, or cause to be sent a commercial electronic message without prior opt-in.

(b) to send, or cause to be sent a designated commercial electronic message without prior opt-in.

(c) to engage in eMarketing activity without prior opt-in.

4.2.4. Virus, denial of service attacks

(a) in connection with any program (including a virus, Trojan horse, worm, cancelbot, time bomb), or activity (including a Denial of Service attack), that is designed to provide or allow any form of unauthorized control of, or result in an adverse effect on, a computer, a network or data (whether the computer, network or data is Text Marketer's or anyone else's);

4.2.5. Open relay and port probing

(a) to access or use Text Marketer's or anyone else's systems, networks or data (including through open relay, port probing and the use of packet sniffers) without consent, regardless of whether or not such access or use has any adverse effect on the system, network or data;

4.3.6. Impersonating

(a) to impersonate any person or entity, including, but not limited to, a Text Marketer official, forum leader, guide or host, or falsely state or otherwise misrepresent your affiliation with a person or entity;

(b) to create or alter in any way and by any means, the contents of an electronic message for the purpose of making the message appear to come from someone other than you, Text Marketer, or the relevant electronic account-holder; or

(c) to create the contents of an electronic message making the message appear to come from someone other than you, where you are not a user authorized to send that message on behalf of the relevant electronic account-holder.

  1. Text Marketer CONDUCT

You acknowledge that Text Marketer and its designees:

(a) are not required to, but may, screen and filter Content in order to monitor compliance with the TOS.

(b) shall have the right (but not the obligation) in their sole discretion to refuse any Content that is available via the Service.

(c) without limiting the foregoing, shall have the right to remove any Content that violates the TOS or is otherwise objectionable.

You agree that you must evaluate, and bear all risks associated with, the use of any Content, including any reliance on the accuracy, completeness, or usefulness of such Content. In this regard, you acknowledge that you may not rely on any Content created by Text Marketer or submitted to Text Marketer. You acknowledge and agree that Text Marketer may preserve Content and may also disclose Content if required to do so by law or in the good faith belief that such preservation or disclosure is reasonably necessary to:

(a) comply with legal process;

(b) enforce the TOS;

(c) respond to claims that any Content violates the rights of third-parties; or

(d) protect the rights, property, or personal safety of Text Marketer, its users and the public.

You understand that the technical processing and transmission of the Service, including your Content, may involve:

(a) transmissions over various networks; and

(b) changes to conform and adapt to technical requirements of connecting networks or devices.

  1. CONTENT SUBMITTED

6.1 Text Marketer does not claim ownership of Content you submit or make available for inclusion on the Service. However, with respect to Content you submit or make available for inclusion on publicly accessible areas of the Service, you grant Text Marketer the following world-wide, royalty free and non-exclusive license(s), as applicable: "Publicly accessible" areas of the Service are those areas of the Text Marketer that are intended by Text Marketer to be available to the general public. By way of example, publicly accessible areas of the Service would include the Text Marketer Feedback. However, publicly accessible areas of the Service would not include portions of Text Marketer that are limited to members.

6.2 Text Marketer will never resell your stored data. Your personal details, your uploaded contact information, your captured mobile numbers will all be kept safe on our secure servers. Data is held on behalf of its clients and partners and is never used for anything other than its intended purpose.

Compliant data centres to meet the most stringent security requirements. Our data centres are accredited to PCI DSS, ISO27001, and SAS70 standards, ensuring your data is secured by the best processes and technologies.

  1. INDEMNITY

You agree to indemnify and hold Text Marketer, and its subsidiaries, affiliates, officers, agents, co-branders or other partners, and employees, harmless from any claim or demand, including reasonable legal fees, made by any third party due to or arising out of Content you submit, post, transmit or make available through the Service, your use of the Service, your connection to the Service, your violation of the TOS, or your violation of any rights of another.

  1. NO RESALE OF SERVICE

You agree not to reproduce, duplicate, copy, sell or exploit for any commercial purposes, any portion of the Service, use of the Service, or access to the Service.

  1. GENERAL PRACTICES REGARDING USE AND STORAGE

You acknowledge that Text Marketer may establish general practices and limits concerning use of the Service, including without limitation the maximum size of any message that may be sent from or received by an account on the Service, and the maximum number of times (and the maximum duration for which) you may access the Service in a given period of time. You agree that Text Marketer has no responsibility or liability for the deletion or failure to store any messages and other communications or other Content maintained or transmitted by the Service. You acknowledge that Text Marketer reserves the right to log off accounts that are inactive for an extended period of time. You further acknowledge that Text Marketer reserves the right to change these general practices and limits at any time, in its sole discretion, with or without notice.

  1. MODIFICATIONS TO SERVICE

Text Marketer reserves the right at any time and from time to time to modify or discontinue, temporarily or permanently, the Service (or any part thereof) with or without notice. You agree that Text Marketer shall not be liable to you or to any third party for any modification, suspension or discontinuance of the Service. This includes assigned mobile telephone numbers and keywords.

  1. TERMINATION

You agree that Text Marketer, in its sole discretion, may terminate your use of the Service, and remove and discard any Content within the Service, for any reason, including, without limitation, for lack of use or if Text Marketer believes that you have violated or acted inconsistently within the letter or spirit of the TOS. Text Marketer may also in its sole discretion and at any time discontinue providing the Service, or any part thereof, with or without notice. You agree that any termination of your access to the Service under any provision of this TOS may be effected without prior notice. Further, you agree that Text Marketer shall not be liable to you or any third-party for any termination of your access to the Service.

  1. DEALINGS WITH ADVERTISERS

Your correspondence or business dealings with, or participation in promotions of, advertisers found on or through the Service, including payment and delivery of related goods or services, and any other terms, conditions, warranties or representations associated with such dealings, are solely between you and such advertiser. You agree that Text Marketer shall not be responsible or liable for any loss or damage of any sort incurred as the result of any such dealings or as the result of the presence of such advertisers on the Service.

  1. LINKS

The Service may provide, or third parties may provide, links to other World Wide Web sites or resources. Because Text Marketer has no control over such sites and resources, you acknowledge and agree that Text Marketer is not responsible for the availability of such external sites or resources, and does not endorse and is not responsible or liable for any Content, advertising, products, or other materials on or available from such sites or resources. You further acknowledge and agree that Text Marketer shall not be responsible or liable, directly or indirectly, for any damage or loss caused or alleged to be caused by or in connection with use of or reliance on any such Content, goods or services available on or through any such site or resource.

  1. Disclaimer of warranties

You expressly understand and agree that:

(a) your use of the service is at your sole risk. The service is provided on an "as is" and "as available" basis. Text Marketer expressly disclaims all warranties of any kind, whether express or implied, including, but not limited to the implied warranties of merchantability, fitness for a particular purpose and non-infringement.

(b) Text Marketer makes no warranty that

(i) the service will meet your requirements,

(ii) the service will be uninterrupted, timely, secure, or error-free,

(iii) the results that may be obtained from the use of the service will be accurate or reliable,

(iv) the quality of any products, services, information, or other material purchased or obtained by you through the service will meet your expectations, and

(v) any errors in the software will be corrected.

(c) any material obtained through the use of the service is done at your own discretion and risk and that you will be solely responsible for any damage to your mobile telephone or loss of data that results from the download of any such material.

(d) no advice or information, whether oral or written, obtained by you from Text Marketer or through or from the service shall create any warranty not expressly stated in the tos.

  1. Limitation of liability

You expressly understand and agree that Text Marketer shall not be liable for any direct, indirect, incidental, special, consequential or exemplary damages, including but not limited to, damages for loss of profits, goodwill, use, data or other intangible losses (even if Text Marketer has been advised of the possibility of such damages), resulting from:

(a) the use or the inability to use the service;

(b) the cost of procurement of substitute goods and services resulting from any goods, data, information or services purchased or obtained or messages received or transactions entered into through or from the service;

(c) unauthorized access to or alteration of your transmissions or data;

(d) statements or conduct of any third party on the service; or

(e) any other matter relating to the service.

  1. Exclusions and limitations

Some jurisdictions do not allow the exclusion of certain warranties or the limitation or exclusion of liability for incidental or consequential damages. Accordingly, some of the above limitations of sections 14 and 15 may not apply to you.

  1. SPECIAL ADMONITION FOR SERVICES RELATING TO FINANCIAL MATTERS

If you intend to create or join any service, receive or request any news, messages, alerts or other information from the Service concerning companies, stock quotes, investments or securities, please read the above Sections 14 and 15 again. They go doubly for you. In addition, for this type of information particularly, the phrase "Let the investor beware" is apt. The Service is provided for informational purposes only, and no Content included in the Service is intended for trading or investing purposes. Text Marketer and its licensors shall not be responsible or liable for the accuracy, usefulness or availability of any information transmitted or made available via the Service, and shall not be responsible or liable for any trading or investment decisions made based on such information.

  1. NOTICE TO CHANGES IN SERVICES AND TERMS

Notices to you may be made via either email or regular SMS. The Service may also provide notices of changes to the TOS or other matters by displaying notices or links to notices to you generally on the Service.

Text Marketer Ltd expressly reserves the right, in its sole and absolute discretion, to alter and/or amend any criteria or information set out in these terms and conditions or any information on the Text Marketer web site without prior notice.

Text Marketer Ltd reserves the right to change and amend the prices and rates quoted on its website without any notice.

You undertake to check the Text Marketer Ltd website (www.textmarketer.co.uk) frequently and to acquaint yourself with the changes and/or amendments in the information supplied on the web site.

You should regularly verify which networks are covered. Changes may occur as to which networks are covered.

  1. GENERAL INFORMATION

The TOS constitute the entire agreement between you and Text Marketer and govern your use of the Service, superseding any prior agreements between you and Text Marketer. You also may be subject to additional terms and conditions that may apply when you use affiliate services, third-party content or third-party software. The TOS and the relationship between you and Text Marketer shall be governed by the laws of the UK without regard to its conflict of law provisions. You and Text Marketer agree to submit to the personal and exclusive jurisdiction of the courts located within the UK. The failure of Text Marketer to exercise or enforce any right or provision of the TOS shall not constitute a waiver of such right or provision. If any provision of the TOS is found by a court of competent jurisdiction to be invalid, the parties nevertheless agree that the court should endeavour to give effect to the parties' intentions as reflected in the provision, and the other provisions of the TOS remain in full force and effect. You agree that regardless of any regulation or law to the contrary, any claim or cause of action arising out of or related to use of the Service or the TOS must be filed within one (1) year after such claim or cause of action arose or be forever barred. The section titles in the TOS are for convenience only and have no legal or contractual effect.

If any provision of this Agreement is held to be illegal, invalid or unenforceable, whether in whole or in part, the enforceability of the remainder of this Agreement shall not be affected.

Any waiver, concession or extra time Text Marketer may allow You are limited to the specific circumstances in which it was given. It does not affect Text Marketer's rights under this Agreement in any other way.

This Agreement shall constitute the complete and exclusive agreement between You and Text Marketer in relation to the Service. While Text Marketer reserves the right to modify this Agreement at any time, the terms and conditions contained in this Agreement may not be modified by You unless both You and an authorised representative of Text Marketer execute a separate written agreement.

Any disputes arising as a consequence of this agreement shall be determined in accordance with the English law and the non-exclusive jurisdiction of the English Court.

The ability to receive text messages to Your mobile phone is dependent on individual mobile operator agreements and subscriptions.

  1. VIOLATIONS

If you believe any Materials are placed on or are transmitted via the Service are in violation of the TOS or any party's rights, you may notify Text Marketer by providing the requested information noted in (a) - (d) below. Text Marketer shall only use such information in accordance with its Privacy Policy and as reasonably necessary to investigate any claims in relation to the allegedly infringing Material:

(a) Complainant's full name and, if applicable, name of complainant's business entity;

(b) Complainant's mailing address, daytime telephone number, facsimile number and email address;

(c) Description or identification of the allegedly infringing Material;

(d) Basis for asserting ownership of or exclusive license to Material;

Text Marketer’s Privacy Policy

Controllers of Personal Information

Any personal information provided to TextMarketer.co.uk (Text Marketer) is controlled primarily by Text Marketer Ltd.

1.1) Personal Data is any data that identifies You or Your account. The Personal Data which You supply to Us You agree will be true, complete and accurate in all respects and You agree to notify Us immediately of any changes to that information within Text Marketer. We will deal with Your Personal Data in compliance with the current UK data protection legislation. Please note this applies only to the Text Marketer Internet not to other companies’ or organisations’ websites to which We link.

1.2) Personal Data will be collected, processed and used by Text Marketer for the purposes of providing the Internet services to You and the other purposes mentioned below.

1.3) We only send email and text messages to You about new products and services which We consider may be of interest to You.

1.4) We may collect Personal Data about Your usage of the services on www.TextMarketer.co.uk in order to provide a service to meet Your needs. However the data will only be disclosed on an anonymous and aggregated basis not in a way in which You will be identified.

1.5) We may hold Personal Data relating to the transactions You enter into with Us. We will disclose Personal Data to a party to the transaction, but only to assist your transaction. We may use Personal Data to let You know about products and services that may be of particular interest to You.

1.6). We may also need to provide certain Personal Data to the regulatory body currently ICSTIS regulating premium line services for the purpose of their assessing our compliance with relevant permissions and guidelines.

1.7) You agree that for the purposes of providing Text Marketer Internet services to You it may be necessary for Your Personal Data to be passed by Us or other organisations involved in providing Internet related companies outside the European Union.

1.8) If You have any questions about the handling or protection of Your Personal Data or Your rights under this Online Agreement please contact us.

1.9) Text Marketer may disclose Your Personal Data acting in good faith if it believes such action is necessary: to conform with a legal requirement or comply with the legal process, protect and defend the rights or property of Text Marketer, enforce this Online Agreement, act to protect the interests of its online account holders or others.

1.10 Cookies

1.10.1) Some websites store information in a small text file called a "cookie," on Your hard disk. Cookies contain information about You and Your preferences. For example, it might contain a record of which pages within the site You visited, to help the site customise the view for You the next time You visit.

1.10.2) Only the information that You provide, or the choices You make while visiting a website, can be stored in a cookie. For example, the site cannot determine Your email name unless You choose to type it. Allowing a website to create a cookie does not give that or any other site access to the rest of Your computer, and only the site that created the cookie can read it.

1.10.3) Text Marketer will only use the cookies created to personalise and secure Your experience. What this means is that when You use the site Text Marketer will be able to keep certain settings for you for when You return. It also means that You do not need to pass security details on every screen as We store them for You during the time You spend browsing our site, these cookies are deleted when You leave.

It is Your responsibility to read and accept the Terms & Conditions which are associated with this Privacy Policy.

Notices

General notices regarding the Service are posted on www.TextMarketer.co.uk or Your mobile operator’s web or WAP site if they are offering the Text Marketer Services (as applicable).

Events outside of Text Marketer's control

We shall not be liable for any delay in performing or failure to perform any obligation hereunder by circumstances beyond our reasonable control including (without limitation) any technical problems beyond the control of Text Marketer such as (for example) defects, congestion or failures of capacity or otherwise in the public data or telephone or mobile telephone network or caused by atmospheric interference, Your mobile being turned off for an extended period of time so that messages are not retained, or Your being unable to obtain mobile network coverage.

Last 7 days, UTC

Average Latency
109ms

Average Uptime
100.0%

Current Status
Online

  • No information
  • Outage
  • Disruption
  • Normal
Average latency determined from Mashape to API Response time
Basic Authentication
 

For authentication you need to provide your API username and password. This is different to the account username and password that you use to log on to messagebox. You can find your API username and password via the cloud interface: http://messagebox.textmarketer.co.uk click settings then the API config tab


Authentication
Description
Parameter
String

HTTP basic username

Username

Required

String

HTTP basic password

Password

Endpoints

HTTP 200 : string GET/credits
SMS Credits

See how many credits you have left, 1 credit = 1 sms (160 chars)


Delivery Reports

HTTP 200 : string GET/deliveryReports
Available Delivery Reports

Get a list of delivery reports available


HTTP 200 : string GET/deliveryReport/{name}
Get a Delivery Report

Get the contents of a delivery report whose name is '<name>' as derived from deliveryReports. Using a name of 'all' retrieves all reports.


Test console
Description
Parameter
string

When we receive a delivery report from the operator for a message that you sent, this gets added to a delivery report on your account with a standardised name. The naming format is as follows: GatewayAPI_DD-MM-YY where • DD is the day in the month • MM is the month • YY is the year
Example: GatewayAPI_04-01-13

name

Required

Send SMS

HTTP 200 : string POST/sms
Send SMS

Send an SMS message or text with up to 612 characters


Test console
Description
Parameter
string

The textual content of the message to be sent. Up to 612 characters (see Concatenationbelow) from the GSM alphabet. The SMS characters we can support are documented below. Please ensure that data is also encoded in UTF-8.
Example: This is a test message

message

Required

number

The mobile number of the intended recipient, in international format, e.g. 447777123123. Only one number is allowed. To send a message to multiple recipients, you must call the API for each number
Example: 447777777777

mobile_number

Required

string

A string (up to 11 alpha-numeric characters) or an international mobile number (up to 16 digits) of the sender, to be displayed to the recipient, e.g. 447777123123 for a UK number.
Example: example

originator

Required

number

Optional. An integer from 1 to 72, indicating the number of hours during which the message is valid for delivery. Messages which cannot be delivered within the specified time will fail.
Example: 72

validity

Optional

string

Optional. An alpha-numeric string, 1-20 characters long, which will be used to 'tag' your outgoing message and will appear in delivery reports, thus facilitating filtering of reports.
Example: branchA

custom

Optional

string

Optional. The date/time to schedule the message for sending. ISO 8601 format. Scheduled messages will not use any credits until sent, however the API response will indicate the number of credits that will be used when the message is sent.
Example: 2011-01-01T01:00:00+00:00

schedule

Optional

string

The username of the source/master account, for authentication. Not required if you use HTTP Basic Authentication instead.
Example: username

username

Optional

string

The password of the source/master account, for authentication. Not required if you use HTTP Basic Authentication instead.
Example: password

password

Optional

  • string – Incorrect username/password, or you do not have sufficient rights to access the specified resource.

    HTTP 403
  • string – Bad request. There was a problem with your request data, see the status message for details.

    HTTP 400

Consume this API completely for free!


By joining the mashape API marketplace you can start using SMS Text messaging functions API today!

Login to your account or signup: Create Account

or
   Signup with GitHub

By signing up you agree to our terms of service.