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:

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


Did this page help you?