WhatsApp API Error MISSING_REQUIRED_TYPE_PROPERTY in WhatsApp Flows JSON

If you're working with WhatsApp Flows you might come across the error: MISSING_REQUIRED_TYPE_PROPERTY

Required property '${propertyName}' is missing.

This means the system expects a specific property—usually "type"—to be present, but it's missing in your JSON.

Let’s break it down.

What Does This Error Mean?

When a component or element is defined in a JSON schema, certain properties are required to identify how the system should render or process it.

One of the most common required fields is "type", which tells the system what kind of component you're working with—like a button, image, or text block.

Example of the Problem

Here’s a broken JSON snippet that throws the error:

{
  "screens": [
    {
      "id": "FIRST",
      "layout": {
        "children": [
          {
            "text": "Description"
          }
        ]
      }
    }
  ]
}

What’s wrong?
The child element has "text" but no "type". 

The Fix: Add the Missing type Property

To resolve the error, simply define the type of the element:

{
  "screens": [
    {
      "id": "FIRST",
      "layout": {
        "children": [
          {
            "type": "text",
            "text": "Description"
          }
        ]
      }
    }
  ]
}

Now the system knows that this child is a text element, and it can render it correctly.

Common Required Properties

Depending on your schema or platform, these are some frequently required fields:

Make sure to refer to the schema documentation for required fields.

For more troubleshooting insights related to WhatsApp Business API, check out heltar.com/blogs.