SMS-API Interface V3.0

Send Message

Request API URL

POST    https://api.innopaas.com/api/sms/v3/msg/send

Request Parameters

Field	Data Type	Required	Description
mobile	String	Yes	Phone number, format (country code + phone number), for example: 8615800000000, where 86 is China's country code; do not prefix the country code with 00. 15800000000 is the real recipient phone number. 5-20 characters Supports multiple; separate multiple entries with commas
msg	String	Yes	SMS content; length must not exceed 2000 characters
senderId	String	No	The sender displayed to the user after receiving the SMS. Customization is not supported domestically; supported abroad but requires prior registration and coordination with carriers. Please confirm specifics with TIG contact.
uid	String	No	Customer-defined batch number, within 64 characters
callBackUrl	String	No	Callback URL for status receipts. Please provide the full address including the http protocol header. If not provided, default is empty. Do not include spaces, as that will cause push address errors. The address can be provided via the API parameter or configured manually in the console.

Request Example (verification code)

{
  "msg": "ongratulations! Your application has been approved. ",
  "mobile": "13800138000,13900139000",
  "senderId": "10690000",
  "uid": "ORDER_20251104_001",
  "callBackUrl": "https://api.example.com/callback/sms"
}

Response Example

{
    "code": "0",
    "message": "Submission successful",
    "data": {
        "messageId": "162575412960104448"
    }
}

Status Report

To be supplemented

Error Code

API Response Code

Status Code	Description
0	Submission Successful
101	Account Does Not Exist
102	Incorrect Password
103	Pull count format error
104	Pull count not within range
105	Batch number exceeds 128 bits
106	SMS content length error (>3000)
108	Phone number format error (>20 or <5)
109	Incorrect number of phone numbers
112	Product configuration error
114	Request IP does not match bound IP
115	Domestic SMS permission not enabled
116	Account deleted or disabled
117	Access number length exceeds 20 characters
119	Account not on current node
123	SMS content cannot be empty
124	Synopsis or verification code cannot be empty
125	A specific customer's phone number cannot exceed ten times per day
128	Account length error (>50 or <=0)
129	Product price configuration error
130	Unknown Exception
131	Exceeded daily sending limit
132	Exceeded monthly sending limit
133	Exceeded sending limit
134	Exceeded anti-complaint limit
150	Sub-account attached billing configuration error
151	Quoted country not enabled
152	Product account quote does not exist
153	Main account for attached billing does not exist
154	Product account billing method does not exist
155	Account has not enabled unified billing
156	Product account disabled
157	Insufficient account balance
158	Insufficient credit limit
159	Customer has not enabled unified wallet

Status Report Error Codes

Status Code	Description
DELIVRD	SMS sent successfully
UNKNOWN	Unknown SMS status
REJECTD	SMS was rejected by the message center
MBBLACK	Destination number is a blacklist number
SM11	Gateway verified number format error
SM12	Our side verified number format error
Other	Gateway internal status

Billing Rules Explanation

1. International SMS does not support emoji

2. Spaces in the editor are represented as ".". If a space without "." appears, it indicates hidden code and may cause one SMS to be counted as two. Please be aware.

3. International numbers must include the corresponding country's area code, for example Chinese number 86138****1234, where 86 is the China country code.

4. When sending to Chinese numbers, the SMS content must start with [signature]. The signature content is: company or brand name, length requirement 2-80 characters; carriers require this field.

5. When sending to Chinese number ranges, content must be legal; cannot send content strictly prohibited by national laws and regulations such as real estate, invoices, immigration, etc.

6. Please include hyperlinks in the SMS content for verification. Some Android systems have hyperlink recognition issues; add spaces before and after the hyperlink.

7. Messages containing non-English characters are billed as Chinese.