Troubleshooting Postman Flows

Whether you're developing an application with code or building a flow with Postman Flows, sometimes things don't work as expected. Debugging is the process of finding the source of the discrepancy between what the flow is doing, and what's expected. Flows has several built-in tools to help with debugging.

Success and failure ports in Send Request blocks

When a Send Request block runs, the output of the block can be viewed after the request has run in either the Success or Failure outputs (depending on the outcome). This is useful for checking that the request is successful and returning the information expected.

Using send request ports

The Output block

The Display block doesn't change the information that passes through it, which makes it ideal for monitoring the data flowing between two blocks. Sometimes, Send Request blocks can return large amounts of information and most of it isn't relevant to the issue being debugged. Selecting only the relevant information and displaying it in a Display block can simplify the process.

Output debugging

The Console

Every request and response is sent to the Postman Console, which keeps a history of events that happened in a flow. If something specific needs to be output to the Console, use the Log block to send the information there. This can be useful when using loops because a Display block would show only the last item passed through it once the flow finished running.

Console logging

General tips

  • If a request is failing, make sure the environment is set, check the Console to inspect the request, and make sure all of the variables are set.
  • Put either Display blocks or Log blocks at every place the information flows when things aren't working as expected.
  • Test only one possible cause at a time to isolate the issue to a single block.

Last modified: 2024/07/01


Postmanaut dancing. Illustration.