---
url: >-
  https://docs.corbitaltech.dev/products/whatsmark-saas/tenant/templates-library.md
description: >-
  Manage and sync WhatsApp message templates from Meta Cloud API in WhatsMark
  SaaS.
---

# Template Library

The Template Library is your central hub for managing WhatsApp message templates that have been created and approved through Meta's WhatsApp Business Platform. This interface allows you to view, sync, and manage all your message templates in one place.

![Template Library Dashboard](../images/templates/template.png)

## Overview

WhatsApp message templates are predefined message formats that businesses use to initiate conversations with customers who have opted in. All templates must be approved by Meta before they can be used for sending messages.

## Accessing Template Library

Navigate to **Tenant Area → Templates** to access the template management interface.

You'll see three main action buttons:

1. **Load Template** - Sync templates from Meta
2. **Template Management** - View and manage synced templates
3. **Create Template** - Create new templates (see [Create Template](./create-template.md) guide)

## Load Template Feature

The **Load Template** button synchronizes all your approved templates from Meta's WhatsApp Cloud API directly into WhatsMarkSaaS.

### When to Use Load Template

Use the Load Template function in these scenarios:

* **Initial Setup**: When you first connect your WhatsApp Business Account and need to import existing templates
* **After Creating Templates in Meta**: When you've created new templates through Meta Business Manager and want to sync them
* **Status Updates**: When template approval statuses have changed (from `PENDING` to `APPROVED` or `REJECTED`)
* **Template Modifications**: After editing templates in Meta Business Manager
* **Missing Templates**: If templates were deleted or renamed and need to be refreshed

::: warning TEMPLATE CREATION OPTIONS
If you need to create templates, you have two options:

1. **Create in Meta Business Manager** - Full feature support, then use **Load Template** to sync
2. **Create in WhatsMarkSaaS** - Direct creation with WhatsApp Cloud API (some limitations apply). See [Create Template](./create-template.md) guide.
   :::

## Working with Templates

Once templates are synced, you can:

* **View template details** including message body, variables, and media
* **Check approval status** before using templates in campaigns
* **Filter templates** by language, category, or status
* **Search templates** by name or content
* **Use templates** in bulk campaigns, template bots, and automated messages

## Creating Templates from Meta Dashboard

If you prefer using Meta's Business Manager to create templates:

1. Go to [Meta Business Manager](https://business.facebook.com/wa/manage/message-templates/)
2. Navigate to **WhatsApp Manager → Message Templates**
3. Click **Create Template** and fill in the required details
4. Submit for approval (usually takes 24-48 hours)
5. Once approved, return to WhatsMarkSaaS
6. Click **Load Template** to sync the new templates

This method gives you access to all template types and features supported by Meta, without any API limitations.

## Webhook Event Subscriptions

To enable **real-time template synchronization** across all tenant accounts, you must configure webhook event subscriptions in your WhatsApp Business Platform settings.

### Required Event Subscriptions

Subscribe to the following webhook events:

* **`message_template_status_update`** - Receives notifications when template approval status changes (e.g., from `PENDING` to `APPROVED` or `REJECTED`)
* **`template_category_update`** - Receives notifications when template categories are modified

### Why These Subscriptions Matter

::: warning **Automatic vs Manual Sync**
**Without webhook subscriptions:**

* Template status and category changes will **NOT sync automatically** to tenant accounts
* Tenants must **manually reload templates** using the **Load Template** button to get the latest status and category information
* Real-time updates for template approval/rejection will not be available

**With webhook subscriptions:**

* Template changes sync automatically across all tenant accounts in real-time
* Tenants always see the most current template status without manual intervention
* Improved workflow efficiency for template management
  :::

### How to Configure Webhook Subscriptions

1. Go to [Meta App Dashboard](https://developers.facebook.com/apps/)
2. Select your WhatsApp Business App
3. Navigate to **WhatsApp → Configuration → Webhook**
4. In the **Webhook fields** section, subscribe to:
   * `message_template_status_update`
   * `template_category_update`
5. Ensure your webhook endpoint is properly configured and verified
6. Save changes

::: tip **Best Practice**
Enable webhook subscriptions during initial setup to ensure all tenants benefit from automatic template synchronization from day one.
:::

## Additional Resources

Learn more about WhatsApp message templates:

* [Meta WhatsApp Cloud API - Send Message Templates](https://developers.facebook.com/docs/whatsapp/cloud-api/guides/send-message-templates/)
* [Message Template Guidelines](https://developers.facebook.com/docs/whatsapp/message-templates/guidelines)
* [Template Components](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/messages#template-object)
