WhatsApp Cloud API · error code

WhatsApp error 132012: Template Parameter Format Mismatch

ConfigurationHTTP 400Templates & Flows

Last verified against Meta for Developers - Cloud API error codes

What WhatsApp returns
Variable parameter values formatted incorrectly.

What error 132012 means

Code 132012 means a parameter value is present and the count is right, but the value is not in the format the template expects. Template parameters are typed: text, currency, date_time, image, video, document, location, and so on. A currency parameter must be an object with fallback_value, code, and amount_1000; a date_time parameter needs a fallback_value; a media header needs a media object with an id or link, not a string. Passing a plain string where a structured object is required, or a structured object where text is expected, produces 132012.

It also appears when a header parameter type does not match the template's header (a text parameter for an image header, or an image for a document header), and when a button component's sub_type or index does not match the approved button layout.

Approval, language, and recipient are all fine; the platform cannot map your value onto the slot's type.

Why it happens

  • A currency or date_time parameter sent as a string instead of the required object.
  • Header parameter type mismatched against the template's header format (text vs image vs document vs video).
  • Media header given a URL string rather than a media object with id or link.
  • Button component with the wrong sub_type, index, or parameter type for a dynamic URL or copy-code button.
  • A location header missing latitude, longitude, name, or address.

How to fix WhatsApp error 132012

  1. 1Fetch the template definition and note each component's format and expected parameter types.
  2. 2Rewrite currency and date_time values as the documented objects with fallback_value.
  3. 3Send media headers as {"type":"image","image":{"id":""}} (or link), matching the header format exactly.
  4. 4Match button components to the approved layout: correct sub_type, index, and parameter type.
  5. 5Retry and save the working payload as a fixture for this template.

How to stop it recurring

Model template parameters as typed structures generated from the template definition, so a currency slot cannot receive a string at compile time. Keep one validated example payload per template in source control and run it against a test recipient whenever the template changes. Parameter object shapes per type are validated by the template checker, and the count-level version of this failure is 132000; both are covered in the error-code guide.

Official reference: Meta for Developers - Cloud API error codes. See all WhatsApp error codes or the WhatsApp limits and quotas.

Related codes

Error 132012 - quick answers

What does WhatsApp error 132012 mean?

Code 132012 means a parameter value is present and the count is right, but the value is not in the format the template expects. Template parameters are typed: text, currency, date_time, image, video, document, location, and so on.

How do I fix WhatsApp error 132012?

1. Fetch the template definition and note each component's format and expected parameter types. 2. Rewrite currency and date_time values as the documented objects with fallback_value. 3. Send media headers as {"type":"image","image":{"id":" "}} (or link), matching the header format exactly. 4. Match button components to the approved layout: correct sub_type, index, and parameter type. 5. Retry and save the working payload as a fixture for this template.

Stop debugging WhatsApp by hand

Connect the channel through Conferbot: tokens, webhooks and retries are handled, failures show as readable status.