Why does my SMS fail with "DLT template ID not found"?
When an SMS fails DLT scrubbing, the operator compares four things: your entity ID, the header, the template ID and the message text. "Template ID not found" and "template mismatch" errors mean one of those didn't line up with what's registered. The fix is almost always on your side and takes minutes once you find which one.
Quick answer
Check that the template ID is approved and copied correctly, that it's linked to the header you send from, and that your message matches the approved text exactly. A newly approved template can also take up to a day to reach every route.The common causes
Work through these in order.
- The template ID has a typo, extra space or was copied from another template
- The template is still pending, was rejected, or has just been approved and hasn't propagated
- The template isn't linked to the header (sender ID) you're sending from
- The text differs from the approved wording: a changed word, extra space or a line break
- The entity ID or telemarketer chain sent with the message is wrong
Watch the invisible differences
Scrubbing compares the fixed text exactly. Double spaces, a full stop added at the end, curly quotes instead of straight ones, or an extra line break all count as a mismatch. Special characters such as + or a line break may also need encoding by your SMS provider's API.
Check the variables
Values that break a variable's rules fail too. A {#numeric#} value with a space or letter, or a value longer than the variable allows, can make the message fail scrubbing even when the template ID is right.
Frequently asked questions
What does "template ID not found" mean?+
How long after approval can I use a template ID?+
Can one template ID be used with several headers?+
How do I check my SMS text against the template?+
Add WhatsApp for messages that must arrive
WhatsApp messages don't go through DLT scrubbing. Send OTPs and alerts on WhatsApp through InfiQ when SMS fails.