Skip to main content

Send SMS

Send an SMS verification code (TAC) to a user's mobile phone. Useful for two-factor authentication, account verification, and transaction confirmation flows.

When to Use​

▾

Use this endpoint when you:

  • Need to verify a user's phone number during signup
  • Want to send a one-time password (TAC) for authentication
  • Require SMS-based confirmation for sensitive transactions
note

Currently supports the VERIFY_CODE type for sending verification codes.

How to Use​

▾
Endpoint
POST/v3/sms

Step 1: Get the User's Phone Details​

▾

Collect the recipient's countryCode and phoneNumber. The country code is the international dialing code without the + sign (e.g., "60" for Malaysia).

Step 2: Prepare the Message​

▾

Construct the SMS content in the message field. Keep it concise — typical TAC messages include the verification code and your app name.

Step 3: Send the Request​

▾

POST the payload to the endpoint with authenticated headers (signature, nonce, timestamp).

Step 4: Check the Response​

▾

A "SUCCESS" code confirms the SMS was queued for delivery. Errors return a code object — see Error Codes.

Request Parameters​

▾
countryCodeSTRINGrequired

International dialing code without `+` (e.g., `"60"` for Malaysia).

Example: "60"

phoneNumberSTRINGrequired

Recipient mobile number without country code.

Example: "163877652"

messageSTRINGrequired

SMS message body to send to the user.

Example: "test"

typeSTRINGrequired

SMS type. Use `"VERIFY_CODE"` for verification codes.

Example: "VERIFY_CODE"

Response Parameters​

▾
codeSTRING

`"SUCCESS"` if the SMS was queued. Otherwise returns an error code. See [Error Codes](../error-codes).

Example: "SUCCESS"

Last updated on by Aiman Danish