Ask the API for one kind of template instead of all of them

Released 7 September 2026

If you build on our API, you can now ask for just your authentication templates, or just the approved ones, instead of fetching everything and filtering it yourself.

What's new

• Filter by category — add category=AUTHENTICATION (or UTILITY, or MARKETING) to a template list, and only that kind comes back. An integration that sends one-time codes no longer pulls down every marketing template to throw it away.
• Filter by review state — add status=APPROVED to get only the templates Meta has approved, which is exactly the set you are allowed to send. The other states are available too, so you can build a screen that shows what is still pending or was rejected.
• They combine with the number you send from — pair either one with wabaId to get, in a single request, the approved authentication templates a particular sender can actually send.
• Capitals do not matter — category=authentication works as well as category=AUTHENTICATION.
• A typo tells you it was a typo — asking for a category or state that does not exist comes back as an error naming the accepted values, rather than an empty list that looks like you simply have none of them.
• Nothing to change on your side — both filters are optional. A request that does not use them returns exactly what it returns today.

List from GET /v1/templates, and find the senders to pair it with at GET /v1/channels. Manage keys under Developers in your workspace settings.