POSThttps://sms-notification.montymobile.com/api/v2/sms/send-otp

Send OTP API

Overview

The Send OTP API is used to deliver One-Time Password (OTP) messages to a mobile number. This API is designed for authentication and verification scenarios.

Request Headers

text
Tenant: {Tenant_ID}
api-key: {API_KEY}
Content-Type: application/json

Request Body

json
{
  "Source": "MontyTest",
  "Message": "test message",
  "Destination": "{Destination}"
}

Request Parameters

ParameterTypeRequiredDescription
SourceStringYesSender ID displayed to the recipient
MessageStringYesOTP message content
DestinationStringYesRecipient mobile number

cURL Example

bash
curl -X POST "https://sms-notification.montymobile.com/api/v2/sms/send-otp" \
-H "Tenant: {Tenant_ID}" \
-H "api-key: {API_KEY}" \
-H "Content-Type: application/json" \
-d '{
  "Source": "MontyTest",
  "Message": "test message",
  "Destination": "{Destination}"
}'

Success Response

json
{
    "message": "Success",
    "code": "8_10_200",
    "success": true,
    "data": {
        "messageId": "xxx",
        "errorCode": 0,
        "description": null,
        "destination": "xxx"
    },
    "version": "2"
}

Response Fields

FieldTypeDescription
messageStringHuman-readable status message (e.g. "Success")
codeStringInternal response code returned by the platform
successBooleanIndicates whether the request was processed successfully
data.messageIdStringUnique identifier assigned to the sent message
data.errorCodeInteger0 indicates no error; a non-zero value indicates a specific failure reason
data.descriptionStringAdditional detail about the result; null when there is no error
data.destinationStringRecipient mobile number the response corresponds to
versionStringAPI version that generated the response