Send Advanced SMS

This method allows you to send a multiple textual message to multiple destination address.


Endpoint Definition

HTTP Methods

  • POST

Parameters

from string  Represents sender ID and it can be alphanumeric or numeric. Alphanumeric sender ID length should be between 3 and 11 characters (Example: CompanyName). Numeric sender ID length should be between 3 and 14 characters. 
mobileTo string  Message destination address. The destination addresses must be in international format (Example: 447950282850).
customerMessageID string The ID that uniquely identifies the message in the customer's platform
text string Text of the message that will be sent.
deliveryReportRequred boolean The property could be true or false. If set to true, the system would send Delivery Report to the URL which the customer has set in the Client area

Examples

POST /api/sms/advancedsms HTTP/1.1
Host: rest.mblsms.com
Authorization: Basic uKvED8rg*huglozYFY8Vd/zznF#*Y9
Content-Type: application/json
Accept: application/json

{
	"Messages":[
		{
			"from":"MBLSMS",
			"destinations":[
				{
					"mobileTo":"447950282850",
					"customerMessageID":"jkhjhasd732jkd"
				},
				{
					"mobileTo":"447950282851",
					"customerMessageID":"ejhjkzi83id"
				}
			],
			"text":"Test SMS.",
			"deliveryReportRequred":true
		},
		{
			"from":"MBLSMS1",
			"destinations":[
				{
					"mobileTo":"447950282852",
					"customerMessageID":"kjqhwdygde7u27"
				},
				{
					"mobileTo":"447950282853",
					"customerMessageID":"jsdyugd37892ddsaa"
				}
			],
			"text":"Test SMS Second",
			"deliveryReportRequred":true
		}
	]

}

Result Format

{
	"results":[
		{
			"mobileTo":"447950282850",
			"customerMessageId":"jkhjhasd732jkd",
			"status":"ACCEPTED",
			"messageId":"c2cbf104-6139-4215-a2h3-f51cb9fb9694"
		},
		{
			"mobileTo":"447950282851",
			"customerMessageId":"ejhjkzi83id",
			"status":"ACCEPTED",
			"messageId":"c2cbf104-6139-4215-a4e1-f51cb9fb9694"
		},
		{
			"mobileTo":"447950282852",
			"customerMessageId":"kjqhwdygde7u27",
			"status":"REJECTED",
			"messageId":""
		},
		{
			"mobileTo":"447950282853",
			"customerMessageId":"jsdyugd37892ddsaa",
			"status":"ERROR",
			"messageId":""
		},
	]
}

Response Format

On success, response header HTTP status code will be 200 OK and the message will be sent. If you try to send message without authorization, you will receive an error 401 Unauthorized.

Parameter  Type  Description 
results Array Array of result items. The system would return one array item for each message that has been sent
mobileTo String  The destination number in international format where your message has been sent 
customerMessageID String  The unique ID of the messages as set by the customer's platform  
status  String 

 The status of the message in our system.

ACCEPTED - The message has been accepted for processing

REJECTED - The message has been rejected by our platform. It has been identified as SPAM by our filters. 

ERROR - There has been internal error and the message has not been processed.

messageID String  The unique ID generated by our system. You can use that ID to request Delivery Report. The ID would be returned only if the status is ACCEPTED. In all other cases this property would be empty 

Possible error codes

HTTP Error Code  Description 
 401 Unauthorized  The Auth Key is missing or is wrong. 
 400 Insufficient account balance.  Your account does not have sufficient credit to process the message. Please top up your account and try again.

Contact us:

Mobilecom Services Ltd

Registered office: 12 Tomfields, Wood Lane, ST7 8PJ, UK

Contact e-mail: support@mblsms.com

Phone number: +44 1782 971973

Company Registration Number 08806860, Registered in England & Wales