Acculync API — send a message with an automatically shortened URL

get

https://sms-eu.rmlconnect.net:8443/bulksms/personalizedcustsms

Use this endpoint when your message content includes a URL that you want the platform to automatically shorten before delivery. Set toshorten=Y and pass the URL(s) to shorten in tobeshorten (URL-encoded, up to four, separated by ||-||).

The message content itself can be either of the following:

Normal text — sent as-is, no conversion needed.
Regional-language content — must first be converted to UCS2 hexadecimal (Unicode
SMS) before submission, with type set to 2 (Unicode). This is the key difference
from the Multilingual Acculync API, where regional content can be sent directly
without conversion.

Sample request URL — normal text, with URL shortening

https://sms-eu.rmlconnect.net:8443/bulksms/personalizedcustsms?username=your_username&password=your_password&source=TESTSM&destination=91XXXXXXXXXX&type=0&message=Hello%20World%20https%3A%2F%2Fexample.com&tagname=campaign1&toshorten=Y&tobeshorten=https%3A%2F%2Fexample.com&udf1=txn123&isCL=1

Sample request URL — regional-language content (UCS2 hex), with URL shortening

https://sms-eu.rmlconnect.net:8443/bulksms/personalizedcustsms?username=your_username&password=your_password&source=TESTSM&destination=91XXXXXXXXXX&type=2&message=00480065007800200065006E0063006F006400650064&tagname=campaign1&toshorten=Y&tobeshorten=https%3A%2F%2Fexample.com&udf1=txn123&isCL=1

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

username

string

required

Account username for the HTTP account.

password

string

required

Account password for the HTTP account.

source

string

required

length ≤ 18

Sender ID shown on the recipient's device. Max 18 characters if numeric, max 11 if alphanumeric.

destination

string

required

Destination number(s), passed as an array of destinations.

type

integer

enum

required

Message type. 0 = Text, 1 = Flash, 2 = Unicode, 4 = WAP Push. Use type 2 (Unicode) when sending UCS2 hex-encoded regional-language content.

Allowed:

message

string

required

Message content, URL encoded. Regional-language content must be converted to UCS2 hexadecimal before being sent.

tagname

string

Optional campaign name for internal reference. (Optional)

toshorten

string

enum

Whether any URL(s) in the message should be shortened. (Optional)

Allowed:

udf1

string

Transaction ID, passed through to the delivery report. (Optional)

isCL

integer

enum

When set to 1, passes UDF parameter values through in the Acculync delivery report. (Optional)

Allowed:

tobeshorten

string

URL-encoded URL(s) within the message that should be shortened. Up to four URLs are supported, separated by ||-||. Submitting more than four rejects the message with error code 1053. (Optional)

Responses

Code	Status	Meaning
1701	Success	Message submitted successfully.
1702	Failed	Invalid request.
1703	Failed	Invalid username or password.
1704	Failed	Invalid message type.
1705	Failed	Invalid message content.
1706	Failed	Invalid destination.
1707	Failed	Invalid source/sender.
1708	Failed	Invalid value for the DLR field.
1709	Failed	User validation failed.
1710	Failed	Unknown error.
1715	Failed	Response timeout.
1025	Failed	Insufficient credit.
1028	Failed	Message flagged as spam.
1032	Failed	Destination is on DND.
1033	Failed	Sender/template mismatch.
1053	Failed	URL link limit exceeded (max 4 links).

400

Malformed request — one or more required query parameters missing or invalid.

401

Authentication failed at the transport/gateway level.

500

Unexpected server error.

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

text/plain