Send OTP Message - Modawer

Endpoint

Field	Value
Method	`POST`
Path	`/api/messages/send-otp`
Content-Type	`application/json`

This endpoint sends OTP messages only through Modawer’s official WhatsApp account. It is the easiest way to start sending OTP messages without linking your own WhatsApp sender.

To send OTPs from your own connected WhatsApp Business account, see Send OTP from Your WhatsApp Account.

Request body

{
  "recipient": "9647701234567",
  "otp": "123456",
  "channels": ["WhatsApp"]
}

Field	Type	Description
`recipient`	`string`	Phone number that receives the OTP message.
`otp`	`string`	One-time password value inserted into the `otp_code_1` authentication template.
`channels`	`MessageChannel[]`	Optional delivery channels. Defaults to `["WhatsApp"]`. Supported values are `"WhatsApp"` and `"Telegram"`.

Required header

X-API-KEY: your-app-token

Success response

{
  "queued": true,
  "messageId": "01a172ee-9200-7000-8000-000000000001",
  "status": "Pending"
}

Save messageId and use Get message status to track receipts.

cURL example

curl -X POST "https://modawer.com/api/messages/send-otp" \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your-app-token" \
  -d '{
    "recipient": "9647701234567",
    "otp": "123456",
    "channels": ["WhatsApp"]
  }'

JavaScript example

const response = await fetch("https://modawer.com/api/messages/send-otp", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-KEY": "your-app-token",
  },
  body: JSON.stringify({
    recipient: "9647701234567",
    otp: "123456",
    channels: ["WhatsApp"],
  }),
});

const data = await response.json();