POpostproxy
WhatsApp

Update a message template

Changes a template’s components or send TTL. Editing components sends it back to Meta review.

patch/api/profiles/{profile_id}/templates/{id}

Request

  • Base URL
    https://api.postproxy.dev
  • URL
    https://api.postproxy.dev/api/profiles/{profile_id}/templates/{id}
  • Auth
    HTTP bearer

Query parameters

profile_group_idstring

Profile group context for the request. Optional when the API key is scoped to a profile group (that group is used automatically); with a full-access key, defaults to the first profile group in the account.

languagestring

Language code

Request body

componentsobject[]

Replaces the whole component array. Status returns to PENDING until Meta approves it again.

message_send_ttl_secondsinteger

New TTL within the category’s range. -1 is not accepted on update.

Response

The updated template.

idstring

Postproxy hashid

external_idstring nullable

Meta’s template id

profile_idstring
namestring

Lowercase letters, digits and underscores, starting with a letter. With language it identifies the template on Meta.

languagestring

Meta language code, e.g. en_US, pt_BR, de

category'UTILITY' | 'MARKETING' | 'AUTHENTICATION'
status'APPROVED' | 'PENDING' | 'REJECTED' | 'PAUSED' | 'DISABLED' | 'IN_APPEAL' | 'PENDING_DELETION'

Meta review status. Only APPROVED templates can be sent.

parameter_format'POSITIONAL' | 'NAMED' | 'null' nullable
componentsobject[]

Meta’s component array — HEADER, BODY, FOOTER, BUTTONS.

message_send_ttl_secondsinteger

Time-to-live for undelivered sends, when the template overrides Meta’s default.

rejected_reasonstring

Present when Meta rejected the template.

quality_scoreobject

Meta’s quality score once scored, e.g. { "score": "GREEN" }.

variable_countinteger

How many variables a send of this template expects.

created_atstring date-time
updated_atstring date-time

Changes

No recorded changes to this operation across all 1 revision of this API.