Template

Update Template

Edits the components of an existing template.

Full-replace semantics

On Meta the edit is full-replace: the component set you send becomes the new state, and any component you do not send is removed. Send every component you want to keep, at minimum body. Sending only body on a template that has a header, footer, and buttons drops them and is rejected with 409 (META_096).

The same applies to limitedTimeOffer — an existing offer is removed if you do not send it again.

After a successful edit the status returns to PENDING for re-review, and the local record is synced.

Constraints

name and language cannot be changed and cannot be sent.
Editing is allowed only when the template is APPROVED, REJECTED, or PAUSED. Any other status returns 409 (META_096).
An active template can be edited only once in 24 hours; exceeding that returns 429 (META_097).
category changes are effective only for REJECTED / PAUSED templates; Meta rejects a category change on an APPROVED one. Changes are subject to review.
carousel is not accepted on edit at all. An existing carousel template’s cards cannot be edited through this API — create a new template instead.

Validation differences from create

Button, header, and body rules are identical to Create Template (WA_TPL_001–005, 015–020, 006–010, 021, 011–014).

The category rules (WA_TPL_022–033) and the name rule (WA_TPL_034) are not evaluated here, since name cannot be sent and the category-vs-component check only runs on create. Meta still enforces the equivalent rules, so a category-incompatible edit comes back as a META_0xx error rather than a WA_TPL_0xx one.

Limited-time offer rules apply as on create, except that the MARKETING check (WA_TPL_048) runs only when you also send a category; if you omit it, Meta validates the offer against the template’s existing category.

POST

{app_id}

templates

{source_id}

Update Template

curl --request POST \
  --url https://public-api.gateway.connexease.com/api/v1/wa/{app_id}/templates/{source_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "header": {
    "format": "TEXT",
    "text": "Order #{{1}} update",
    "examples": [
      "12345"
    ]
  },
  "body": {
    "text": "Hi {{1}}, your order {{2}} is now {{3}}. Thank you.",
    "examples": [
      "John",
      "#12345",
      "shipped"
    ]
  },
  "footer": {
    "text": "Connexease"
  },
  "buttons": [
    {
      "type": "QUICK_REPLY",
      "text": "Track"
    }
  ]
}
'

import requests

url = "https://public-api.gateway.connexease.com/api/v1/wa/{app_id}/templates/{source_id}"

payload = {
    "header": {
        "format": "TEXT",
        "text": "Order #{{1}} update",
        "examples": ["12345"]
    },
    "body": {
        "text": "Hi {{1}}, your order {{2}} is now {{3}}. Thank you.",
        "examples": ["John", "#12345", "shipped"]
    },
    "footer": { "text": "Connexease" },
    "buttons": [
        {
            "type": "QUICK_REPLY",
            "text": "Track"
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    header: {format: 'TEXT', text: 'Order #{{1}} update', examples: ['12345']},
    body: JSON.stringify({
      text: 'Hi {{1}}, your order {{2}} is now {{3}}. Thank you.',
      examples: ['John', '#12345', 'shipped']
    }),
    footer: {text: 'Connexease'},
    buttons: [{type: 'QUICK_REPLY', text: 'Track'}]
  })
};

fetch('https://public-api.gateway.connexease.com/api/v1/wa/{app_id}/templates/{source_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://public-api.gateway.connexease.com/api/v1/wa/{app_id}/templates/{source_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'header' => [
        'format' => 'TEXT',
        'text' => 'Order #{{1}} update',
        'examples' => [
                '12345'
        ]
    ],
    'body' => [
        'text' => 'Hi {{1}}, your order {{2}} is now {{3}}. Thank you.',
        'examples' => [
                'John',
                '#12345',
                'shipped'
        ]
    ],
    'footer' => [
        'text' => 'Connexease'
    ],
    'buttons' => [
        [
                'type' => 'QUICK_REPLY',
                'text' => 'Track'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://public-api.gateway.connexease.com/api/v1/wa/{app_id}/templates/{source_id}"

	payload := strings.NewReader("{\n  \"header\": {\n    \"format\": \"TEXT\",\n    \"text\": \"Order #{{1}} update\",\n    \"examples\": [\n      \"12345\"\n    ]\n  },\n  \"body\": {\n    \"text\": \"Hi {{1}}, your order {{2}} is now {{3}}. Thank you.\",\n    \"examples\": [\n      \"John\",\n      \"#12345\",\n      \"shipped\"\n    ]\n  },\n  \"footer\": {\n    \"text\": \"Connexease\"\n  },\n  \"buttons\": [\n    {\n      \"type\": \"QUICK_REPLY\",\n      \"text\": \"Track\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://public-api.gateway.connexease.com/api/v1/wa/{app_id}/templates/{source_id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"header\": {\n    \"format\": \"TEXT\",\n    \"text\": \"Order #{{1}} update\",\n    \"examples\": [\n      \"12345\"\n    ]\n  },\n  \"body\": {\n    \"text\": \"Hi {{1}}, your order {{2}} is now {{3}}. Thank you.\",\n    \"examples\": [\n      \"John\",\n      \"#12345\",\n      \"shipped\"\n    ]\n  },\n  \"footer\": {\n    \"text\": \"Connexease\"\n  },\n  \"buttons\": [\n    {\n      \"type\": \"QUICK_REPLY\",\n      \"text\": \"Track\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://public-api.gateway.connexease.com/api/v1/wa/{app_id}/templates/{source_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"header\": {\n    \"format\": \"TEXT\",\n    \"text\": \"Order #{{1}} update\",\n    \"examples\": [\n      \"12345\"\n    ]\n  },\n  \"body\": {\n    \"text\": \"Hi {{1}}, your order {{2}} is now {{3}}. Thank you.\",\n    \"examples\": [\n      \"John\",\n      \"#12345\",\n      \"shipped\"\n    ]\n  },\n  \"footer\": {\n    \"text\": \"Connexease\"\n  },\n  \"buttons\": [\n    {\n      \"type\": \"QUICK_REPLY\",\n      \"text\": \"Track\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "sourceId": "<string>",
    "name": "<string>",
    "language": "<string>",
    "category": "UTILITY",
    "status": "APPROVED",
    "components": [
      {
        "type": "HEADER",
        "format": "TEXT",
        "text": "<string>",
        "example": {
          "headerText": [
            "<string>"
          ],
          "headerHandle": [
            "<string>"
          ],
          "headerUrl": [
            "<string>"
          ],
          "bodyText": [
            [
              "<string>"
            ]
          ]
        },
        "buttons": [
          {
            "type": "URL",
            "text": "<string>",
            "url": "<string>",
            "phone_number": "<string>",
            "example": [
              "<string>"
            ],
            "otp_type": "COPY_CODE",
            "autofill_text": "<string>",
            "package_name": "<string>",
            "signature_hash": "<string>",
            "zero_tap_terms_accepted": true
          }
        ],
        "cards": [
          {
            "components": [
              {
                "type": "HEADER",
                "format": "IMAGE",
                "text": "<string>",
                "example": {
                  "headerText": [
                    "<string>"
                  ],
                  "headerHandle": [
                    "<string>"
                  ],
                  "headerUrl": [
                    "<string>"
                  ],
                  "bodyText": [
                    [
                      "<string>"
                    ]
                  ]
                },
                "buttons": [
                  {
                    "type": "URL",
                    "text": "<string>",
                    "url": "<string>",
                    "phone_number": "<string>",
                    "example": [
                      "<string>"
                    ],
                    "otp_type": "COPY_CODE",
                    "autofill_text": "<string>",
                    "package_name": "<string>",
                    "signature_hash": "<string>",
                    "zero_tap_terms_accepted": true
                  }
                ]
              }
            ]
          }
        ],
        "addSecurityRecommendation": true,
        "codeExpirationMinutes": 123,
        "limitedTimeOffer": {
          "text": "<string>",
          "hasExpiration": false
        }
      }
    ],
    "qualityScore": "GREEN",
    "rejectedReason": "NONE",
    "parameterFormat": "POSITIONAL"
  },
  "isSuccess": true
}

{
  "isSuccess": false,
  "errors": {
    "code": "META_075",
    "group": "VALIDATION",
    "description": "Template with 0000000000 not found in Meta.",
    "params": {},
    "fields": {}
  }
}

{
  "isSuccess": false,
  "errors": {
    "code": "META_075",
    "group": "VALIDATION",
    "description": "Template with 0000000000 not found in Meta.",
    "params": {},
    "fields": {}
  }
}

{
  "isSuccess": false,
  "errors": {
    "code": "META_075",
    "group": "VALIDATION",
    "description": "Template with 0000000000 not found in Meta.",
    "params": {},
    "fields": {}
  }
}

{
  "isSuccess": false,
  "errors": {
    "code": "META_075",
    "group": "VALIDATION",
    "description": "Template with 0000000000 not found in Meta.",
    "params": {},
    "fields": {}
  }
}

{
  "errors": {
    "code": "META_096",
    "group": "CONFLICT",
    "description": "Template update failed. Template is not in an editable status (editable only when APPROVED, REJECTED or PAUSED; it may be PENDING after a recent edit)."
  },
  "isSuccess": false
}

{
  "isSuccess": false,
  "errors": {
    "code": "META_075",
    "group": "VALIDATION",
    "description": "Template with 0000000000 not found in Meta.",
    "params": {},
    "fields": {}
  }
}

{
  "isSuccess": false,
  "errors": {
    "code": "META_075",
    "group": "VALIDATION",
    "description": "Template with 0000000000 not found in Meta.",
    "params": {},
    "fields": {}
  }
}

{
  "isSuccess": false,
  "errors": {
    "code": "META_075",
    "group": "VALIDATION",
    "description": "Template with 0000000000 not found in Meta.",
    "params": {},
    "fields": {}
  }
}

Authorizations

Authorization

string

header

required

Secret key in Bearer sk_... format. Server-to-server only — never embed it in a browser or mobile client. The organization is resolved from the key, so organization_id is never passed explicitly.

Headers

Prefer

enum<string>

default:return=representation

return=representation (default) returns the current record; return=minimal returns no body. The response echoes the choice in Preference-Applied.

Available options:

return=representation,

return=minimal

Path Parameters

app_id

string

required

Application ID. Must belong to the organization resolved from your secret key, otherwise the request returns 404 with APPLICATION_004.

Example:

"app_7poyXj8GXuv76e"

source_id

string

required

The template's Meta source ID.

Example:

"1234567890123456"

Body

application/json

body

object

required

Show child attributes

header

object

Show child attributes

footer

object

Show child attributes

buttons

object[]

Maximum array length: 10

Show child attributes

messageSendTtlSeconds

integer

limitedTimeOffer

object

Show child attributes

Response

The updated template re-fetched from Meta, with status: "PENDING". With Prefer: return=minimal the data key is omitted entirely — the response is exactly { "isSuccess": true }, still HTTP 200.

data

object

Null fields (id, createdAt, updatedAt, messageSendTtlSeconds, correctCategory, previousCategory) are dropped from the response.

Show child attributes

isSuccess

enum<boolean>

Available options:

true

Update Template

curl --request POST \
  --url https://public-api.gateway.connexease.com/api/v1/wa/{app_id}/templates/{source_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "header": {
    "format": "TEXT",
    "text": "Order #{{1}} update",
    "examples": [
      "12345"
    ]
  },
  "body": {
    "text": "Hi {{1}}, your order {{2}} is now {{3}}. Thank you.",
    "examples": [
      "John",
      "#12345",
      "shipped"
    ]
  },
  "footer": {
    "text": "Connexease"
  },
  "buttons": [
    {
      "type": "QUICK_REPLY",
      "text": "Track"
    }
  ]
}
'

import requests

url = "https://public-api.gateway.connexease.com/api/v1/wa/{app_id}/templates/{source_id}"

payload = {
    "header": {
        "format": "TEXT",
        "text": "Order #{{1}} update",
        "examples": ["12345"]
    },
    "body": {
        "text": "Hi {{1}}, your order {{2}} is now {{3}}. Thank you.",
        "examples": ["John", "#12345", "shipped"]
    },
    "footer": { "text": "Connexease" },
    "buttons": [
        {
            "type": "QUICK_REPLY",
            "text": "Track"
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    header: {format: 'TEXT', text: 'Order #{{1}} update', examples: ['12345']},
    body: JSON.stringify({
      text: 'Hi {{1}}, your order {{2}} is now {{3}}. Thank you.',
      examples: ['John', '#12345', 'shipped']
    }),
    footer: {text: 'Connexease'},
    buttons: [{type: 'QUICK_REPLY', text: 'Track'}]
  })
};

fetch('https://public-api.gateway.connexease.com/api/v1/wa/{app_id}/templates/{source_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://public-api.gateway.connexease.com/api/v1/wa/{app_id}/templates/{source_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'header' => [
        'format' => 'TEXT',
        'text' => 'Order #{{1}} update',
        'examples' => [
                '12345'
        ]
    ],
    'body' => [
        'text' => 'Hi {{1}}, your order {{2}} is now {{3}}. Thank you.',
        'examples' => [
                'John',
                '#12345',
                'shipped'
        ]
    ],
    'footer' => [
        'text' => 'Connexease'
    ],
    'buttons' => [
        [
                'type' => 'QUICK_REPLY',
                'text' => 'Track'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://public-api.gateway.connexease.com/api/v1/wa/{app_id}/templates/{source_id}"

	payload := strings.NewReader("{\n  \"header\": {\n    \"format\": \"TEXT\",\n    \"text\": \"Order #{{1}} update\",\n    \"examples\": [\n      \"12345\"\n    ]\n  },\n  \"body\": {\n    \"text\": \"Hi {{1}}, your order {{2}} is now {{3}}. Thank you.\",\n    \"examples\": [\n      \"John\",\n      \"#12345\",\n      \"shipped\"\n    ]\n  },\n  \"footer\": {\n    \"text\": \"Connexease\"\n  },\n  \"buttons\": [\n    {\n      \"type\": \"QUICK_REPLY\",\n      \"text\": \"Track\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://public-api.gateway.connexease.com/api/v1/wa/{app_id}/templates/{source_id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"header\": {\n    \"format\": \"TEXT\",\n    \"text\": \"Order #{{1}} update\",\n    \"examples\": [\n      \"12345\"\n    ]\n  },\n  \"body\": {\n    \"text\": \"Hi {{1}}, your order {{2}} is now {{3}}. Thank you.\",\n    \"examples\": [\n      \"John\",\n      \"#12345\",\n      \"shipped\"\n    ]\n  },\n  \"footer\": {\n    \"text\": \"Connexease\"\n  },\n  \"buttons\": [\n    {\n      \"type\": \"QUICK_REPLY\",\n      \"text\": \"Track\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://public-api.gateway.connexease.com/api/v1/wa/{app_id}/templates/{source_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"header\": {\n    \"format\": \"TEXT\",\n    \"text\": \"Order #{{1}} update\",\n    \"examples\": [\n      \"12345\"\n    ]\n  },\n  \"body\": {\n    \"text\": \"Hi {{1}}, your order {{2}} is now {{3}}. Thank you.\",\n    \"examples\": [\n      \"John\",\n      \"#12345\",\n      \"shipped\"\n    ]\n  },\n  \"footer\": {\n    \"text\": \"Connexease\"\n  },\n  \"buttons\": [\n    {\n      \"type\": \"QUICK_REPLY\",\n      \"text\": \"Track\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "sourceId": "<string>",
    "name": "<string>",
    "language": "<string>",
    "category": "UTILITY",
    "status": "APPROVED",
    "components": [
      {
        "type": "HEADER",
        "format": "TEXT",
        "text": "<string>",
        "example": {
          "headerText": [
            "<string>"
          ],
          "headerHandle": [
            "<string>"
          ],
          "headerUrl": [
            "<string>"
          ],
          "bodyText": [
            [
              "<string>"
            ]
          ]
        },
        "buttons": [
          {
            "type": "URL",
            "text": "<string>",
            "url": "<string>",
            "phone_number": "<string>",
            "example": [
              "<string>"
            ],
            "otp_type": "COPY_CODE",
            "autofill_text": "<string>",
            "package_name": "<string>",
            "signature_hash": "<string>",
            "zero_tap_terms_accepted": true
          }
        ],
        "cards": [
          {
            "components": [
              {
                "type": "HEADER",
                "format": "IMAGE",
                "text": "<string>",
                "example": {
                  "headerText": [
                    "<string>"
                  ],
                  "headerHandle": [
                    "<string>"
                  ],
                  "headerUrl": [
                    "<string>"
                  ],
                  "bodyText": [
                    [
                      "<string>"
                    ]
                  ]
                },
                "buttons": [
                  {
                    "type": "URL",
                    "text": "<string>",
                    "url": "<string>",
                    "phone_number": "<string>",
                    "example": [
                      "<string>"
                    ],
                    "otp_type": "COPY_CODE",
                    "autofill_text": "<string>",
                    "package_name": "<string>",
                    "signature_hash": "<string>",
                    "zero_tap_terms_accepted": true
                  }
                ]
              }
            ]
          }
        ],
        "addSecurityRecommendation": true,
        "codeExpirationMinutes": 123,
        "limitedTimeOffer": {
          "text": "<string>",
          "hasExpiration": false
        }
      }
    ],
    "qualityScore": "GREEN",
    "rejectedReason": "NONE",
    "parameterFormat": "POSITIONAL"
  },
  "isSuccess": true
}

{
  "isSuccess": false,
  "errors": {
    "code": "META_075",
    "group": "VALIDATION",
    "description": "Template with 0000000000 not found in Meta.",
    "params": {},
    "fields": {}
  }
}

{
  "isSuccess": false,
  "errors": {
    "code": "META_075",
    "group": "VALIDATION",
    "description": "Template with 0000000000 not found in Meta.",
    "params": {},
    "fields": {}
  }
}

{
  "isSuccess": false,
  "errors": {
    "code": "META_075",
    "group": "VALIDATION",
    "description": "Template with 0000000000 not found in Meta.",
    "params": {},
    "fields": {}
  }
}

{
  "isSuccess": false,
  "errors": {
    "code": "META_075",
    "group": "VALIDATION",
    "description": "Template with 0000000000 not found in Meta.",
    "params": {},
    "fields": {}
  }
}

{
  "errors": {
    "code": "META_096",
    "group": "CONFLICT",
    "description": "Template update failed. Template is not in an editable status (editable only when APPROVED, REJECTED or PAUSED; it may be PENDING after a recent edit)."
  },
  "isSuccess": false
}

{
  "isSuccess": false,
  "errors": {
    "code": "META_075",
    "group": "VALIDATION",
    "description": "Template with 0000000000 not found in Meta.",
    "params": {},
    "fields": {}
  }
}

{
  "isSuccess": false,
  "errors": {
    "code": "META_075",
    "group": "VALIDATION",
    "description": "Template with 0000000000 not found in Meta.",
    "params": {},
    "fields": {}
  }
}

{
  "isSuccess": false,
  "errors": {
    "code": "META_075",
    "group": "VALIDATION",
    "description": "Template with 0000000000 not found in Meta.",
    "params": {},
    "fields": {}
  }
}

Getting Started

Sandbox Public API

Analytics

Application

Template

Media

Developers

Reference

Update Template

Full-replace semantics

Constraints

Validation differences from create

Authorizations

Headers

Path Parameters

Body

Response