Sending SMS & MMS Messages

URL:

https://api2.protexting.com/v1/sms/send?access_token=your_access_token

Method:

POST

* limit: 10 SMS per same recipient number per minute

• The limit for outgoing SMS is 480 characters - sent as multipart message (3 SMS)

• Each SMS will count as 1 credit and MMS as 3 credits sent in the USA.  For international coverage, please refer to international messaging credits.

• Sending MMS: create "MMS templates" first.  Once the "MMS templates" are approved, use the approved "MMS templates" to send MMS messages.

• IMPORTANT: Please test your campaign well before going live to make sure the correct number of SMS are sent out.

Request parameters:

* required parameters

 * "SendFrom" parameter can be used if multiple short codes and long numbers are set in the account. If empty, account code/s will be used as default "SendFrom" on a rotating basis

Response parameters:

Example Request:

curl -i -H "Accept:application/json" -H "Content-Type:application/json" -XPOST "https://api2.protexting.com/v1/sms/send?access_token=your_access_token" -d '{"MobilePhone":"16461234567","Message":"Test Message","ResourceLink":""}'

Example Response Headers:

Status Code: 200 OK
Cache-Control: no-store, no-cache, must-revalidate, post-check=0, pre-check=0
Connection: Keep-Alive
Content-Type: application/xml; charset=utf-8
Keep-Alive: timeout=5, max=100
Link: <https://api2.protexting.com/v1/sms/send?access_token=your_access_token>; 
rel=self Pragma: no-cache Transfer-Encoding: chunked X-Pagination-Current-Page: 1 X-Pagination-Page-Count: 1 X-Pagination-Per-Page: 100 X-Pagination-Total-Count: 1 X-Powered-By: PHP/5.6.2 X-Rate-Limit-Limit: 60 X-Rate-Limit-Remaining: 59 X-Rate-Limit-Reset: 0

Example Response Body:

{
    	"Id":"8cccf554cd42bf1b22bcc2d9b4e4571a4a87c9d0",
        "DeliveryReportUrl": "https://api2.protexting.com/v1/sms/delivery-report?access_token=your_access_token&id=8cccf554cd42bf1b22bcc2d9b4e4571a4a87c9d0",
        "Message":"Text message to 1646xxxxxxx has been sent."
}

		

<response>
    <Id>8cccf554cd42bf1b22bcc2d9b4e4571a4a87c9d0</Id>
    <DeliveryReportUrl>https://api2.protexting.com/v1/sms/delivery-report?access_token=your_access_token&id=8cccf554cd42bf1b22bcc2d9b4e4571a4a87c9d0</DeliveryReportUrl>
    <Message>Text message to 1646xxxxxxx has been sent.</Message>
</response>