ZendSMS integration guide

Server-side fetch + REST API

Connect a Node.js service to ZendSMS.

Send SMS from a trusted Node.js backend, queue worker or serverless function without exposing the API key in a browser.

Discuss your setup API documentation

Node.jsBusiness event

ZendSMS202 QUEUED

YOURBRAND

Your login code is 482910. Do not share this code.

✓ Delivered

Integration typeServer-side fetch + REST API

Security patternServer-side only

Response202 Accepted + message_id

Common workflows

What you can send from Node.js.

Use the ZendSMS REST API from a protected JavaScript or TypeScript runtime.

API events

Send transactional SMS after a validated backend request.

Queue workers

Process message jobs away from the user-facing request.

OTP flow

Keep send and verify calls inside protected server routes.

Webhook handling

Update your records when delivery information arrives.

Verified API pattern

From one business event to one trackable SMS.

This request uses the fields in the current ZendSMS Send SMS reference. Keep the API key in a secret store, attach a unique client_ref and save the message_id from the accepted response.

01
Define the workflow
Choose the event, recipient and message that should be sent.
02
Connect securely
Keep the API key on the server and make the request over HTTPS.
03
Map the template
Map the approved sender ID, recipient, message and client reference.
04
Test and launch
Check the result, segment count and delivery state before production.

POST /api/v1/send-sms202

Authorization: Bearer sk_your_api_key

{
    "recipient": "8801700000000",
    "sender_id": "YOURBRAND",
    "message": "Your login code is 482910. Do not share this code.",
    "client_ref": "node-auth-2048"
}

success: truestatus: QUEUEDmessage_id: UUID

Read the complete Send SMS reference

Included in the workflow

Build a production-ready flow, not just a send button.

Event-driven SMS

Send only when a selected business event occurs.

Every core SMS type

Use OTP, Masking or Non-Masking SMS for the approved use case.

References you can track

Keep your own client reference and the returned message ID.

Bangla and Unicode

Send Bangla, English or Unicode content for the customer journey.

Node.js FAQ

Answers to review before production.

A concise guide to security, SMS types, delivery reconciliation and testing.

Should the Node.js integration call the API from a browser?

No. A secret API key must never be placed in browser code or public JavaScript. Send requests from a trusted server, backend function or protected connector.

Which SMS types can Node.js send?

You can use OTP, Masking and Non-Masking SMS for an approved use case. Sender ID and template activation remain subject to KYC, documents and applicable operator or regulatory approval.

How do I reconcile delivery results?

Attach a unique client_ref to each request and store the message_id returned in the accepted response. Reconcile delivery status using the current API documentation.

What should be tested before launch?

Test event mapping, recipient format, Bangla/Unicode segments, duplicate prevention, error handling and delivery results. Complete consent and compliance review before production.

Ready to connect?

Talk to the ZendSMS team about your Node.js workflow.

Talk on WhatsApp

Chat on WhatsApp