Template migration

Updated: Jun 24, 2026

This document describes how to migrate templates from one WhatsApp Business account (WABA) to another. Migration doesn’t move templates; it recreates them in the destination WABA.

Limitations

Templates can only be migrated between WABAs owned by the same Meta business.

Only templates with a status of APPROVED and a quality_score of either GREEN or UNKNOWN are eligible for migration.

Request syntax

Use the Migrate Message Templates API to migrate templates from one WABA to another.

curl -X POST "https://graph.facebook.com/<API_VERSION>/<DESTINATION_WABA_ID>/migrate_message_templates" \
-H "Authorization: Bearer <ACCESS_TOKEN>" \
-H "Content-Type: application/json" \
-d '
{
  "source_waba_id": "<SOURCE_WABA_ID>",
  "page_number": <PAGE_NUMBER>,
  "count": <COUNT>,
  "template_ids": [<TEMPLATE_IDS>]
}'

Parameters

Placeholder	Description	Example value
`<ACCESS_TOKEN>` String	Required. System token or business token.	`EAAA...`
`<API_VERSION>` String	Optional. Graph API version.	v25.0
`<COUNT>` Integer	Optional. Overrides the default batch size with a maximum count of 500. If the request takes longer than 30 seconds to execute and times out, reduce the count number.	`200`
`<DESTINATION_WABA_ID>` WhatsApp Business account ID	Required. Destination WhatsApp Business account ID.	`104996122399160`
`<PAGE_NUMBER>` Integer	Optional. Indicates the number of templates to migrate as sets of 500. Zero-indexed. For example, to migrate 1000 templates, send one request with this value set to `0` and another request with this value set to `1`, in parallel.	`0`
`<TEMPLATE_IDS>` Array of strings	Optional. Only use to migrate specific template IDs with a max array length of 500. For example, to migrate failed template IDs, add the specific template ID to the array.	`["35002248699842","351234565148","54382248699842"]`
`<SOURCE_WABA_ID>` WhatsApp Business account ID	Required. Source WhatsApp Business account ID.	`102290129340398`

Response

{
  "migrated_templates": [<MIGRATED_TEMPLATES>],
  "failed_templates": [<FAILED_TEMPLATES>]
}

Response properties

Placeholder	Description	Example value
`<MIGRATED_TEMPLATES>` List	List of template IDs that were successfully duplicated in the destination WhatsApp Business account.	`"1473688840035974","6162904357082268","6147830171896170"`
`<FAILED_TEMPLATES>` Map	Map identifying templates that were not duplicated in the destination WhatsApp Business account. Keys are template IDs and values are failure reasons.	`"1019496902803242":"Incorrect category","259672276895259":"Formatting error - dangling parameter","572279198452421":"Incorrect category"`

Example request

The following request migrates templates from the source WABA 102290129340398 to the destination WABA 104996122399160:

curl -X POST 'https://graph.facebook.com/v25.0/104996122399160/migrate_message_templates?source_waba_id=102290129340398&page_number=0' \
-H 'Authorization: Bearer EAAJB...'

Example response

{
  "migrated_templates": [
    "1473688840035974",
    "6162904357082268",
    "6147830171896170"
  ],
  "failed_templates": {
    "1019496902803242": "Incorrect category",
    "259672276895259": "Formatting error - dangling parameter",
    "572279198452421": "Incorrect category"
  }
}