All Collections
Understanding and Resolving the "Invalid Payload" Error in API Integration
Understanding and Resolving the "Invalid Payload" Error in API Integration
Iuri Guedes Emer avatar
Written by Iuri Guedes Emer
Updated over a week ago

In the realm of software development and API integration, encountering errors is not uncommon. One such error that developers may come across is the "Invalid Payload" error, often accompanied by a message like: "errorMessage: Invalid payload. Error: Unexpected character ('<' (code 60)): expected a valid value".

What Causes the Error?

The core reason behind this error is the mismatch between the expected data format and the actual data format received from the external service. In simpler terms, when the component expects JSON data but receives something else, such as XML, it fails to process the response correctly, leading to the "Invalid Payload" error.

Why Does it Happen?

This error occurs primarily due to a discrepancy in data formats. Many APIs are designed to send responses in a specific format, often JSON, to ensure compatibility and ease of parsing. However, if the external service returns data in a format other than what the receiving component anticipates, it cannot interpret the response properly, triggering the error.

How to Resolve the Issue?

Resolving the "Invalid Payload" error involves addressing the mismatch between the expected and actual data formats. Here's a step-by-step guide to tackle this issue:

  1. Identify the Source: Begin by identifying which endpoint or external service is returning the unexpected data format. This can often be determined by analyzing the error message and tracing it back to its source.

  2. Enable Advanced Mode: Within the component that is returning the error, open the settings and enable the advanced mode.

  3. Enable "Raw Mode": After enabling advanced mode, enable the "raw mode". This allows the component to display the raw response from the external service.

  4. Save and Deploy: Save the changes and deploy the new version of the component. The next time the error occurs, it will display the details in the format sent by the external endpoint, facilitating understanding of the generated error.


The "Invalid Payload" error is a common hurdle faced during API integration, often stemming from discrepancies in data formats between the component and the external service. By understanding the underlying cause of the error and following the steps outlined above, developers can effectively resolve this issue and ensure smooth communication between their application and external services.

Did this answer your question?