Tutorials · 26 Oct 2026
SMS API Integration Tutorial with Python and Node.js
By Team SMS-COOL
This SMS API integration Python Node.js tutorial shows how to rent a number, trigger a verification code and read the incoming message from your backend. The examples focus on a clean, production-safe structure with environment variables, timeouts and error handling.
Direct answer: Authenticate with your API key, request an available number, use that number in the app you are testing, then poll the API for the inbound SMS. In Python use requests; in Node.js use fetch or axios. Always keep secrets in environment variables.
Prerequisites
- An SMS-COOL account and API key
- Python 3 or Node.js installed
- A staging app that sends OTP codes
- The API documentation open for endpoint details
Python Example
- Install requests.
- Store your API key in an environment variable.
- Request a number for your target country.
- Trigger the OTP from your app.
- Poll for the message and extract the code.
- Release the number when finished.
Node.js Example
- Use fetch with async and await.
- Load the key from process.env.
- Reserve a number for the required duration.
- Read messages on a short interval.
- Handle non-200 responses with retries.
Error Handling Checklist
| Case | Action |
|---|---|
| 401 Unauthorized | Check key and environment variable |
| 429 Rate limited | Back off with exponential delay |
| Timeout | Retry once, then log request ID |
| Empty inbox | Wait and retry within the rental window |
Production Tips
- Never commit keys to source control
- Use a staging-only test harness
- Log the number, rental ID and request ID
- Release numbers in a finally block to avoid leaks
- Monitor costs against your rental plan
Frequently Asked Questions
Which language is better for SMS API work?
Both work well. Python suits scripting and test automation; Node.js fits web backends.
How do I read the SMS automatically?
Poll the inbox endpoint on a short interval, or use webhooks if your provider supports them.
Can I test multiple countries?
Yes. Request numbers per country and validate your region logic in staging.
Is it safe to use a virtual number for OTP in development?
Yes - it keeps test traffic away from real user numbers.
Conclusion
With this SMS API integration Python Node.js walkthrough you can build a reliable OTP test harness. Start with a key from SMS-COOL.
Related reading: more API tutorials on the SMS-COOL blog.