WhatsApp Cloud API · error code

WhatsApp error 131008: Required parameter is missing

ConfigurationHTTP 400Generic & request errors

Last verified against Meta for Developers - Cloud API error codes

What WhatsApp returns
The request is missing a required parameter.

What error 131008 means

Code 131008 means your request omitted a field the endpoint cannot work without. It is the WhatsApp messaging layer's version of a required-field validation error and it is always deterministic: the same payload will fail the same way every time until the field is added. The message string or error_data.details usually names the missing parameter.

On the /messages endpoint the fields most often missing are messaging_product (which must be the string whatsapp on every send), to, type, and the object matching that type, such as a text object with a body or a template object with name and language. On registration endpoints it is often the six-digit PIN. On media it is the file or the type.

This has nothing to do with permissions, rate limits, or the recipient. It is purely the shape of the request.

Like code 100, this is a synchronous, pre-queue rejection - nothing is billed and nothing arrives in webhooks. The request-shape walkthrough in the error-code guide shows a valid payload for each message type, and template payloads can be validated with the template checker before they reach the API.

Why it happens

  • messaging_product omitted from the body; every Cloud API send requires it.
  • The type field set to template but no template object, or the template object missing language.code.
  • A text message with no body, or an interactive message missing the action object.
  • Registration call without the pin field.
  • A serializer that drops fields with empty values, silently removing something required.

How to fix WhatsApp error 131008

  1. 1Read the message and error_data.details; the parameter name is usually stated.
  2. 2Compare the payload against the endpoint reference for that message type and add the missing field.
  3. 3Check your serializer settings so required fields are never stripped when their value is empty or default.
  4. 4Add the corrected payload to your test fixtures and retry.

How to stop it recurring

Construct messages with typed builders that make required fields non-optional at compile or construction time, and validate against a per-type schema before sending. A contract test that sends each message type to a test number on every release will catch regressions in required fields before customers do.

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

Related codes

Error 131008 - quick answers

What does WhatsApp error 131008 mean?

Code 131008 means your request omitted a field the endpoint cannot work without. It is the WhatsApp messaging layer's version of a required-field validation error and it is always deterministic: the same payload will fail the same way every time until the field is added. The message string or error_data.details usually names the missing parameter.

How do I fix WhatsApp error 131008?

1. Read the message and error_data.details; the parameter name is usually stated. 2. Compare the payload against the endpoint reference for that message type and add the missing field. 3. Check your serializer settings so required fields are never stripped when their value is empty or default. 4. Add the corrected payload to your test fixtures and retry.

Stop debugging WhatsApp by hand

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