Voice OTP API in Node.js: Code Example

Send a Voice OTP from Node.js

Call this from your server. Keep the API key in an environment variable, never in client code.

// Node.js 18+ (built-in fetch)
const res = await fetch("https://voice-api.edesy.in/v1/voice-otp/send", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.EDESY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    phone_number: "9876543210",       // 10-digit Indian mobile
    otp_code: "482913",               // optional - omit to get a 6-digit code
    message_template: "Your Acme code is {{otp}}. I repeat, {{otp}}.", // optional
    gather_enabled: true,             // optional - ask the user to press 1
    callback_url: "https://your-app.com/webhooks/voice-otp",
    external_id: "signup-123",        // optional - your own reference
  }),
});
const call = await res.json();
// { data: { id, call_sid, phone_number, otp_code, status, created_at }, meta }
// Store call.data.otp_code against the user and compare when they type it in.

The result arrives on your webhook

Status is one of delivered, no-answer, busy or failed. dtmf_response is set when you enable press-1 confirmation.

POST https://your-app.com/webhooks/voice-otp
X-Edesy-Event: voice-otp.completed
Content-Type: application/json

{
  "id": "5b1c...-uuid",
  "external_id": "signup-123",
  "phone_number": "9876543210",
  "status": "delivered",
  "dtmf_response": "1",
  "duration_sec": 18,
  "price": "1.5000",
  "completed_at": "2026-09-26T10:15:30Z"
}