Templates API

The Templates API enables you to programmatically create, manage, synchronize, and deploy WhatsApp Business message templates. In the WhatsApp Business ecosystem, outbound broadcasts must utilize pre-approved structured templates containing verified header, body, footer, and interactive button components. Pingr AI offers a two-tier template management system:

Custom Templates API: Create and register bespoke templates directly on Meta Graph API and track their approval lifecycles.
Meta Template Library API: Browse Meta’s curated catalog of pre-approved global industry templates and provision them to your WhatsApp Business Account (WABA) instantaneously.

+-------------------------------------------------------------+
|               WhatsApp Message Template Lifecycle           |
|                                                             |
|   +-----------------------+     +-----------------------+   |
|   |   Custom Template     |     |  Meta Library Catalog |   |
|   | (Header/Body/Buttons) |     | (Pre-approved design) |   |
|   +-----------+-----------+     +-----------+-----------+   |
|               \                             /               |
|                v                           v                |
|              +-------------------------------+              |
|              |   Meta Graph API Submission   |              |
|              |      (v19.0 WABA Gateway)     |              |
|              +---------------+---------------+              |
|                              |                              |
|                              v                              |
|              +-------------------------------+              |
|              |     Automated Review State    |              |
|              |  (PENDING -> APPROVED/REJECT) |              |
|              +---------------+---------------+              |
|                              |                              |
|                              v                              |
|              +-------------------------------+              |
|              |   Pingr AI Local Database     |              |
|              | (Sync & Campaign Orchestration)|             |
|              +-------------------------------+              |
+-------------------------------------------------------------+

Key Capabilities

Direct Meta Submission

Submit custom marketing, utility, and authentication templates directly to Meta Graph API v19.0.

Pre-Approved Template Library

Query Meta’s global message template library by industry, topic, language, and use case for instant adoption.

Bi-Directional Synchronization

Sync existing approved templates from your WhatsApp Business Account directly into Pingr AI’s database.

Quality Score Monitoring

Track template health, recipient feedback flags, and quality status scores (GREEN, YELLOW, RED).

Template Structure & Components

WhatsApp message templates are composed of modular components:

Component Type	Description	Permitted Formats
`HEADER`	Optional leading element displayed at the top of the message	`TEXT` (with single variable), `IMAGE`, `VIDEO`, `DOCUMENT`
`BODY`	Mandatory main text containing placeholders (`{{1}}`, `{{2}}`)	Plain text up to 1,024 characters with indexed variable parameters
`FOOTER`	Optional muted footer text at the bottom	Plain text up to 60 characters (no variables)
`BUTTONS`	Optional interactive actionable elements	`QUICK_REPLY` (canned responses), `URL` (web links), `PHONE_NUMBER`

Template Categories

Meta strictly classifies all templates into three distinct pricing and delivery categories:

MARKETING: Promotional offers, product announcements, newsletters, and lead engagement messages.
UTILITY: Account updates, order confirmations, billing notifications, and appointment reminders.
AUTHENTICATION: One-time passwords (OTP) and two-factor verification codes with auto-fill or copy-code actions.

Review & Operational Lifecycles

Status	Meaning	Can Broadcast?
`PENDING`	Under automated or manual review by Meta	No
`APPROVED`	Approved and ready for immediate campaign dispatching	Yes
`REJECTED`	Did not meet Meta Business or Commerce Policies	No
`PAUSED`	Halted by Meta due to poor user quality feedback	No

Available Endpoints

Custom Templates

Method	Endpoint	Description
POST	`/api/v1/templates`	Create a new template locally and submit to Meta
GET	`/api/v1/templates`	List paginated templates for your organization
GET	`/api/v1/templates/{template_id}`	Retrieve single template details and components
DELETE	`/api/v1/templates/{template_id}`	Delete a template locally and on Meta
POST	`/api/v1/templates/sync`	Sync all templates from Meta for a specific channel

Templates Library

Method	Endpoint	Description
GET	`/api/v1/templates/library`	Search and browse pre-approved templates from Meta’s library
POST	`/api/v1/templates/library/{template_id}/create`	Provision an official library template for your WABA

‹ Previous

Create template

POST /api/v1/templates

Next ›

Overview

Agents

Campaigns

Contacts

Templates

Knowledge Base

Webhooks

Call Logs

Quick Replies

Inbox

Templates Overview

Templates API

Key Capabilities

Direct Meta Submission

Pre-Approved Template Library

Bi-Directional Synchronization

Quality Score Monitoring

Template Structure & Components

Template Categories

Review & Operational Lifecycles

Available Endpoints

Custom Templates

Templates Library

​Templates API

​Key Capabilities

Direct Meta Submission

Pre-Approved Template Library

Bi-Directional Synchronization

Quality Score Monitoring

​Template Structure & Components

​Template Categories

​Review & Operational Lifecycles

​Available Endpoints

​Custom Templates

​Templates Library

Templates API

Key Capabilities

Template Structure & Components

Template Categories

Review & Operational Lifecycles

Available Endpoints

Custom Templates

Templates Library