Sign in
WhatsApp

Update template by id

Update one variant's components and/or its message_send_ttl_seconds by its Meta id. Name, language and category cannot change.

Meta only allows editing templates in APPROVED, REJECTED or PAUSED state; an approved template can be edited once per 24 hours and up to 10 times per 30 days. A component update sends the variant back to Meta for review, so the status returned here is normally PENDING; a TTL-only update keeps an APPROVED variant approved. The final outcome arrives on the whatsapp.template.status_updated webhook (which carries the variant's templateId and language). A variant already in PENDING cannot be edited again until Meta finishes reviewing it.

patch/v1/whatsapp/templates/id/{templateId}

Path parameters

templateIdstring required

Meta template id (numeric).

Request body

accountIdstring required

WhatsApp account ID

message_send_ttl_secondsinteger

Delivery validity window in seconds: a message not delivered within it is dropped. Range depends on category: AUTHENTICATION 30 to 900, UTILITY 30 to 43200 (12h), MARKETING 43200 to 2592000 (30 days); -1 is not accepted here (Meta treats it as an empty edit); send a value in range. A TTL-only edit keeps an APPROVED template approved, no re-review. Meta defaults to 600 for AUTHENTICATION and 30 days otherwise. If Meta later recategorises the template, it clears the TTL (read it back to check).

Response

Template updated successfully

successboolean

Example response

{
  "template": {
    "status": "PENDING"
  }
}

Changes