The SMS API document provides specifications of the API for the automated sending of SMS via the internet through
HTTPS mode. This API document is intended for the developers and clients alike who plan to integrate their systems with the Bulk SMS service of Gupshup.

Pre start checklist

To start using the SMS API, you should have:

User name & password. If you don’t have an account, you can create one at https://enterprise.smsgupshup.com
URL encoding of your message, password etc.

For any queries, our support is available for you at 022 42006799 or email us at [email protected].

The SMS API is designed to allow you to access an SSL Enabled connection for added security. It supports Hypertext Transfer Protocol over the Secure Socket Layer (HTTPS) protocol.

Authentication

The API supports only a Plain Authentication Scheme for users. This authentication scheme requires only the user ID and password. The connection security is provided through HTTPS protocol.

In addition to SSL, the API is designed to allow you to securely send sensitive data to the Gupshup platform by encrypting the data using Advanced Encryption Standard i.e. AES 256-bit encryption. At your request (please reach out to us at 022 42006799 or email us at [email protected], a 256-bit symmetric key is generated by Gupshup and set up for your account.

You must use this key to encrypt API parameter values when sending the API request. Once the request is received by Gupshup, the payload is decrypted by Gupshup and sent ahead to the operator.

Message Length

No of Messages	Text characters	Unicode characters
1 SMS 2 SMS 3 SMS	160-characters 306-characters 459-characters	70-characters 134-characters 201-characters
4 SMS 5 SMS 6 SMS	612-characters 765-characters 918-characters	268-characters 335-characters 402-characters
7 SMS 8 SMS 9 SMS	1071-characters 1224-characters 1377-characters	469-characters 536-characters 603-characters
10 SMS 11 SMS 12 SMS 13 SMS 14 SMS 15 SMS 16 SMS 17 SMS 18 SMS 19 SMS 20 SMS 21 SMS 22 SMS 23 SMS 24 SMS 25 SMS 26 SMS 27 SMS 28 SMS 29 SMS 30 SMS	1530-characters 1683-characters 1836-characters 1989-characters 2142-characters 2295-characters 2448-characters 2601-characters 2754-characters 2907-characters 3060-characters 3213-characters 3366-characters 3519-characters 3672-characters 3825-characters 3978-characters 4131-characters 4284-characters 4437-characters 4590-characters	670-characters 737-characters 804-characters 871-characters 938-characters 1005-characters 1072-characters 1139-characters 1206-characters 1273-characters 1340-characters 1407-characters 1474-characters 1541-characters 1608-characters 1675-characters 1742-characters 1809-characters 1876-characters 1943-characters 2000-characters
31 SMS	4743-characters
32 SMS 33 SMS 34 SMS	4896-characters 5049-characters 5202-characters
35 SMS 36 SMS 37 SMS	5355-characters 5508-characters 5661-characters
38 SMS 39 SMS 40 SMS	5814-characters 5967-characters 6120-characters
41 SMS 42 SMS 43 SMS	6273-characters 6426-characters 6579-characters
44 SMS	6732-characters
45 SMS 46 SMS	6885-characters 7038-characters
47 SMS	7191-characters
48 SMS 49 SMS 50 SMS	7344-characters 7497-characters 7650-characters
51 SMS	7803-characters
52 SMS	7956-characters
53 SMS	8000-characters