The INVALID_PROPERTY_VALUE_FORMAT error occurs when a property’s value does not follow the required format. This means that while the property itself is valid, the value assigned to it does not match the expected format.

Error Message Example

INVALID_PROPERTY_VALUE_FORMAT

Property '${propertyName}' should be in '${format}' format.

For example:

Property 'data_channel_uri' must be in 'uri' format.

Understanding the Issue

Let’s look at an example where this error occurs:

{
  "version": "2.1",
  "data_channel_uri": "placeholder_uri",
  "screens": [
    ...
  ]
}

Here, the data_channel_uri property expects a valid URI format, but the value "placeholder_uri" does not follow the correct structure (e.g., https://example.com).

Common Causes of This Error

  1. Invalid URI Format

    • Incorrect: "data_channel_uri": "placeholder_uri"

    • Correct: "data_channel_uri": "https://api.example.com/channel"

  2. Date Format Issues: Some properties may require a specific date format (YYYY-MM-DD or ISO 8601).

  3. Unexpected Number or String Formats: Ensure numerical values do not contain unwanted characters (e.g., 1,000 instead of 1000).

How to Fix It?

  • Identify the Property: Check the error message for the property name.

  • Verify the Required Format: Refer to the Flow JSON documentation to find the correct format.

  • Update the Value: Modify the property value to match the required format.

Fixed JSON Example

{
  "version": "2.1",
  "data_channel_uri": "https://api.example.com/channel",
  "screens": [
    ...
  ]
}

Now, the data_channel_uri property has a valid URI format, resolving the error.

Tip: Use JSON validation tools to catch errors early and always refer to official documentation before adding new properties.

By ensuring that all property values adhere to the correct format, you can prevent INVALID_PROPERTY_VALUE_FORMAT errors in your Flow JSON.

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