Idempotency keys for OTP sends
Prevent duplicate OTPs when your app retries. Pass a UUIDv4 Idempotency-Key header on /v2/otp/send and we return the original response without triggering a new send.
If your application retries a send request because of a network blip, you can end up sending two OTPs to the same user. Idempotency keys prevent this completely.
How to use them
- 01Generate a unique key (we recommend a UUIDv4) for each OTP request.
- 02Pass it in the Idempotency-Key header on POST /v2/otp/send.
- 03If the same key arrives within 24 hours, we return the original response without sending a second OTP.
- 04Keep the key until you receive a terminal status (delivered, failed, or expired).
Related articles in OTP & Transactional
Browse other help categories
Getting started
Create your account, add INR credits, complete DLT registration and send your first compliant SMS, WhatsApp message or OTP — all in under fifteen minutes.
SMS campaigns
SMS content templates, DLT routing, sender ID setup, delivery report statuses, bulk campaign scheduling, throttle controls, and automatic retry logic for India.
WhatsApp Business API
Business API onboarding, template approval and categories, broadcast consent rules, quality rating and tiers, and setting up a shared WhatsApp team inbox.
AI WhatsApp Agents
Train your AI WhatsApp agent on your own knowledge, sync your product catalogue, configure handoff triggers, and serve customers across twelve Indian languages.
Did this article help?
If something isn't clear or the steps don't match what you're seeing, tell us and we'll fix the doc the same day.