Send SMS using XML API

The XML API supports utf-8 encoded XML. Requests should be made using HTTP POST with a Content-Type of text/xml. For performance reasons the maximum request size is 500 messages.

URL : https://www.smsgatewayhub.com/RestAPI/MT.svc/mt

XML API :

Single Message :

<SmsQueue><Account><User>abc</User><Password>123</Password><SenderId>TESTIN</SenderId><Channel>1</Channel><DCS>0</DCS><FlashSms>0</FlashSms><Route>1</Route></Account><Messages><Message><Number>9198981XXXXX</Number><Text>Messge from xml</Text></Message></Messages></SmsQueue>

Multiple Messages :

Response :<SmsResponse><ErrorCode>000</ErrorCode><ErrorMessage>Success</ErrorMessage><JobId>2463227</JobId><MessageData><Messages><Number>919898xxxxxx</Number><MessageId>Jb7qIygj2kGp63Q0ZE0rjw</MessageId></Messages></MessageData></SmsResponse>

URL : https://www.smsgatewayhub.com/RestAPI/MT.svc/mt?data=

XML API :

Single Message :

Multiple Messages :

Parameter Name	Parameter Value	Description
Account
User	abc	Your system login name
Password	111	Your system password
SenderId	TESTIN	Sender id which you want to relay message from
Channel	1 / Promo (for Promotional) 2 / Trans (for Transactional)	To send from which channel you want to send message promotional or transactional
DCS	0 (for PlainText) 5 (for Binary) 8 (for Unicode)	Appropriate data-coding will affect the message submission Multiple language supporting
FlashSms	0 (Normal SMS) 1 (Flash SMS / Immediate Display)	To send immediate display message pass 1 else normal message pass 0
Optional Parameters
SchedTime	2015/12/31 22:35:00 PM YYYY/MM/DDHH:MM:SS AM/PM	Set the date and time to schedule messages
GroupId	### Group Id	Group Id from My Groups Page
Route	1/2/3/# Route Id	Route id from which route gateway you want to send sms
Messages
Number	919898xxxxx	Message recipient
Text	Hello world my first message.	Message to send

Below are the error codes which you can receive after message submission :

Error Code	Description
000	Success
001	login details cannot be blank
003	sender cannot be blank
004	message text cannot be blank
005	message data cannot be blank
006	error: generic error description
007	username or password is invalid
008	account not active
009	account locked, contact your account manager
010	api restriction
011	ip address restriction
012	invalid length of message text
013	mobile numbers not valid
014	account locked due to spam message contact support
015	senderid not valid
017	groupid not valid
018	multi message to group is not supported
019	schedule date is not valid
020	message or mobile number cannot be blank
021	insufficient credits
022	invalid jobid
023	parameter missing
024	invalid template or template mismatch
025	{Field} can not be blank or empty
026	invalid date range
027	invalid optin user

XML API :

Balance Check :

URL :https://www.smsgatewayhub.com/RestAPI/MT.svc/balance?user=aa&password=aa
<BalanceResponse><ErrorCode>0</ErrorCode><ErrorMessage>Success</ErrorMessage><Balance>P:9#T:10</Balance></BalanceResponse>

Delivery Report :

URL :https://www.smsgatewayhub.com/RestAPI/MT.svc/report/2463357
<DeliveryReportResponse><ErrorCode>0</ErrorCode><ErrorMessage>Success</ErrorMessage><Messag/><DeliveryReports><DeliveryReport><MessageId>6lScvygr5Uiw32Hus7DJRg</MessageId><DeliveryStatus>Delivered</DeliveryStatus><DeliveryDate>2015-11-22T00:02:52.247</DeliveryDate></DeliveryReport><DeliveryReport><MessageId>6lScvygr5Uiw32Hus7DJRg</MessageId><DeliveryStatus>Delivered</DeliveryStatus><DeliveryDate>2015-11-22T00:02:57.483</DeliveryDate></DeliveryReport></DeliveryReports></DeliveryReportResponse>

Sender Id :

URL :https://www.smsgatewayhub.com/RestAPI/MT.svc/senderid?user=aa&password=aa&type=1
<SenderIdResponse><ErrorCode>0</ErrorCode><ErrorMessage>Success</ErrorMessage><Type>1</Type><SenderIdList><SenderIds><SenderId>WEBTXT</SenderId></SenderIds><SenderIds><SenderId>TESTIN</SenderId></SenderIds></SenderIdList></SenderIdResponse>

Templates :

URL :https://www.smsgatewayhub.com/RestAPI/MT.svc/template?user=aa&password=aa
<TemplatesResponse><ErrorCode>0</ErrorCode><ErrorMessage>Success</ErrorMessage><TemplateId>1</TemplateId><TemplateName>Temp</TemplateName><TemplateString>This is temp %Field% template.</TemplateString></TemplatesResponse>

Groups :

URL :https://www.smsgatewayhub.com/RestAPI/MT.svc/groups?user=aa&password=aa
<GroupResponse><ErrorCode>0</ErrorCode><ErrorMessage>Success</ErrorMessage><Groups><Group><GroupId>22</GroupId><GroupName>Group1</GroupName><ContactsCount>0</ContactsCount></Group><Group><GroupId>23</GroupId><GroupName>demo</GroupName><ContactsCount>0</ContactsCount></Group><Group><GroupId>25</GroupId><GroupName>mgage</GroupName><ContactsCount>6</ContactsCount></Group><Group><GroupId>26</GroupId><GroupName>DEMO</GroupName><ContactsCount>0</ContactsCount></Group></Groups></GroupResponse>

Generate XML API