Quick Send SMS - United States

This API is to send SMS messages using the Cellcast API in the United States region.

Parameters for Send SMS API

Headers Parameters

Parameters	Description
Authorization	Please add provided Bearer token - linked to your Cellcast account. Check here
Content-Type	application/json
region	US

Request Body Parameters

Name	Example	Description
action	send_sms	The action to perform
sender	#SharedNum#	#SharedNum# or Sender ID (Custom ID)
senderType	#SharedNum#	The type of sender ID used. Currently, only '#SharedNum#' and 'Sender ID' (dedicatedNumber) are supported.
message	SMS Text goes here	The SMS message content. This is a required field. To insert a new line, use "\r\n" within the message string (e.g., "Hello\r\nWorld").
contacts	["2130000000"]	A JSON-encoded array containing recipient phone numbers. This is a required field. To send to multiple recipients, list their numbers in the array (e.g., ["2130000000", "3120000000"]). You can include up to 1,000 numbers in a single API call.
longUrl	[{"longUrl": "www.google.com", "shortUrl": "goo"}]	The long URL to be shortened and embedded in your message. The short URL must be at least 3 alphanumeric characters. Include the short URL in your message using the format m.gosite.au/ (e.g., m.gosite.au/goo).
optout	true	Set to true to enable the Custom Opt-Out feature using the optoutId.
optoutId	6682440ea000000000000000	The unique identifier of the Custom Opt-Out to be used. Check here to get your Custom Opt-Out ID. Leave this empty to use the default custom opt-out set here
replyStopToOptOut	false	Set to false when the optout feature is enabled

Code Samples

Post https://us.mymessagecentre.com/api/qm

cURL

curl --location 'https://us.mymessagecentre.com/api/qm' \
--header 'authorization: Bearer {{API_KEY}}' \
--header 'content-type: application/json' \
--header 'region: US' \
--data '{
    "action": "send_sms",
    "data": {
        "sender": "#SharedNum#",
        "senderType": "#SharedNum#",
        "message": "Test API 😀",
        "contacts": [
            "2130000000"
        ],
        "optout": true,
        "replyStopToOptOut": false,
        "optoutId": "672a05747000000000000000"
    }
}'

Replace with the actual API key that you own.

Responses

Response Body

Name	Example	Description
MessageId	67d2ade01000000000000000	A unique identifier for the message, automatically generated by the system.
Contact	12130000000	The contact number formatted by the system after processing the request.

200 Success

{
    "is_error": false,
    "message": "success send message",
    "data": {
        "queueResponse": [
            {
                "Contact": "12130000000",
                "MessageId": "67d2b88cd000000000000000",
                "Result": "Message added to queue"
            }
        ],
        "message": "success register all valid contacts to queue",
        "invalidContacts": [],
        "unsubscribeContacts": [],
        "totalValidContact": 1,
        "totalInvalidContact": 0,
        "totalUnsubscribeContact": 0
    }
}

401 Unauthorized

{
    "is_error": true,
    "message": "invalid token"
}

422 Unprocessable Entity (Credit is too Low)

{
    "is_error": true,
    "message": "Your balance is too low for this request, please recharge"
}