Template

whatsapp.template.reviewed

The Webhook notifies you of state changes to existing templates.

Trigger condition：

• APPROVED

• PENDING_DELETION

• REJECTED

• PAUSED

• DISABLED

• IN_APPEAL

Example

{
  "eventId": "evt.2010646226294276096",
  "wabaId": "1356068476048619",
  "apiVersion": "v1.0",
  "type": "whatsapp.template.reviewed",
  "value": {
    "message_template_name": "template_marketing_20261012_1",
    "message_template_category": "MARKETING",
    "event": "REJECTED",
    "message_template_language": "en",
    "message_template_id": 1265737232054643,
    "reason": "INVALID_FORMAT",
     <!-- only included if template rejected with INVALID_FORMAT reason -->
    "rejection_info": {
      "reason": "The content is the same as the content in another rejected template.",
      "recommendation": "You need to change the content of your template."
    }
  }
}

Webhook payload structures

Key	Type	Description
message_template_name	String	Whatsapp Template name.
message_template_category	String	Whatsapp Template category.
event	String	Whatsapp Template Status.
message_template_language	String	Whatsapp Template language.
message_template_id	int	Whatsapp Template ID.
reason	String	The reason why the template was rejected.
rejection_info	String	Explain in detail why the template did not pass the audit.

whatsapp.template.quality_updated

Send notifications about changes to the template quality score.

Example

{
  "eventId":"evt.2010999070230839296",
  "wabaId":"1234667498220443",
  "apiVersion":"v1.0",
  "type":"whatsapp.template.quality_updated",
  "value":{
    "message_template_id":1866762624210878,
    "message_template_name":"template_authentication_20251225151228",
    "previous_quality_score":"UNKNOWN",
    "new_quality_score":"GREEN",
    "message_template_language":"en"
  }
}

Webhook payload structures

Key	Type	Description
message_template_id	int	Whatsapp Template ID.
message_template_name	String	Whatsapp Template name.
previous_quality_score	String	The previous quality score of the template. GREEN 、RED、YELLOW、UNKNOWN
new_quality_score	String	The new quality score of the template. GREEN 、RED、YELLOW、UNKNOWN
message_template_language	String	Whatsapp Template language.

whatsapp.template.components_updated

Notifies you of changes to the template component.

Example

{
  "eventId": "evt.20110092115504223512",
  "wabaId": "124543923220447",
  "apiVersion": "v1.0",
  "type": "whatsapp.template.components_updated",
  "value": {
    "message_template_id": 3810417762595384,
    "message_template_name": "String",
    "message_template_element": "Shop now through {{1}} and use code {{2}} to get {{3}} off of all merchandise.",
    "message_template_language": "en",
    
    <!-- only included if template has a text header -->
    "message_template_title": "Our {{1}} is on!",
    
    <!-- only included if template has a footer -->
    "message_template_footer": "Use the buttons below to manage your marketing subscriptions",
    
  }
}

Webhook payload structures

Key	Type	Description
message_template_id	int	Whatsapp Template ID.
message_template_name	String	Whatsapp Template name.
message_template_element	String	Template body.
message_template_language	String	Whatsapp Template language.
message_template_title	String	Template title text.
message_template_footer	String	Template footer text.

whatsapp.template.category_updated

Notifying you of template category changes.

Example

{
  "eventId": "evt.2000874476527438848",
  "wabaId": "1356068856048619",
  "apiVersion": "v1.0",
  "type": "whatsapp.template.category_updated",
  "value": {
    "message_template_id": 1999028225593766000,
    "message_template_name": "String",
    "message_template_language": "en-US",
    "new_category": "MARKETING",
    <!-- completed category change notifications only -->
    "previous_category": "UTILITY",
    <!-- impending category change notifications only -->
    "correct_category": "MARKETING",
    "category_update_timestamp": 1746169200
  }
}

Webhook payload structures

Key	Type	Description
message_template_id	int	Whatsapp Template ID.
message_template_name	String	Whatsapp Template name.
message_template_language	String	Whatsapp Template language.
new_category	String	New category of template.
previous_category	String	The category before the template.
correct_category	String	The category to which the template will be reclassified within 24 hours.
category_update_timestamp	int	Timestamp when the template category was updated