Skip to content
Meta Business PartnerQuick answer inside

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.

Do this with InfiQ

Frequently asked questions

What does "template ID not found" mean?+
The operator couldn't find an approved template with that ID for your entity. The ID is mistyped, not approved yet, belongs to another entity, or hasn't reached every route.
How long after approval can I use a template ID?+
Often within hours, but some providers advise allowing 24 to 48 hours before every route recognises a new template ID.
Can one template ID be used with several headers?+
Yes, if you link the template to each header on your DLT portal. Sending it from a header it isn't linked to fails scrubbing.
How do I check my SMS text against the template?+
Copy the approved text from your portal, fill in the variables, and compare it with what your system sends. A template checker can also flag variable problems before you submit.

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.