Send a request with the HTTP Request block

You can build a flow that uses a request from your workspace or the Postman API Network. You can also create a new request when building your flow.

In this tutorial, you’ll create a new flow, collection, and request. Then, you’ll use the HTTP Request block to send a request to the Postman Echo API.

Create a new flow

You build flows in a workspace. Workspaces let you organize your API projects and collaborate with your team.

To create a new flow, do the following:

Choose an existing workspace or create a new one.
Click Flows > More actions > New flow.

Add an HTTP Request block and create a request

With an HTTP Request block, you can select a request from your collection or create a new request. In this tutorial, you’ll create a new request with the HTTP Request block.

To add an HTTP Request block and create a new request, do the following:

In the sidebar, select your new flow.
Click Add blocks > HTTP Request.
Click Find or create new request. The collections in your workspace appear in a dropdown list.
Select a collection and click Create a new request. If you don’t have any collections, click Create a new request. The Postman Flows request editor opens.
In the request editor, select a method from the dropdown list and enter a URL.
(Optional) Edit the request’s name.
(Optional) Edit the request’s parameters, headers, and body.
Click Save.

To edit a request in an existing HTTP Request block, click Requests in the right sidebar, then select the HTTP Request block whose request you want to edit.

Connect a Display block

When you connect two blocks, you connect one block’s input to another block’s output. Inputs are on the block’s left side and outputs are on its right side.

The Display block shows incoming data, such as the HTTP Request block’s outgoing API response.

To connect a Display block, do the following:

Hover over the HTTP Request block’s Success output port. The pointer changes to a crosshair.
Decide where on the canvas you want to place the Display block and drag the port to that location.
Click Display. If you want to search for the block, enter Display in search.

Run the flow

From the canvas toolbar, click Run.

Send a request flow

Congratulations! You sent a request and displayed the response in a Display block.

You can build a flow that uses a request from your workspace or the Postman API Network. You can also create a new request when building your flow.

In this tutorial, you’ll create a new flow, collection, and request. Then, you’ll use the HTTP Request block to send a request to the Postman Echo API.

Create a new flow

You build flows in a workspace. Workspaces let you organize your API projects and collaborate with your team.

To create a new flow, do the following:

Choose an existing workspace or create a new one.
Click Flows > More actions > New flow.

Add an HTTP Request block and create a request

With an HTTP Request block, you can select a request from your collection or create a new request. In this tutorial, you’ll create a new request with the HTTP Request block.

To add an HTTP Request block and create a new request, do the following:

In the sidebar, select your new flow.
Click Add blocks > HTTP Request.
Click Find or create new request. The collections in your workspace appear in a dropdown list.
Select a collection and click Create a new request. If you don’t have any collections, click Create a new request. The Postman Flows request editor opens.
In the request editor, select a method from the dropdown list and enter a URL.
(Optional) Edit the request’s name.
(Optional) Edit the request’s parameters, headers, and body.
Click Save.

To edit a request in an existing HTTP Request block, click Requests in the right sidebar, then select the HTTP Request block whose request you want to edit.

Connect a Display block

When you connect two blocks, you connect one block’s input to another block’s output. Inputs are on the block’s left side and outputs are on its right side.

The Display block shows incoming data, such as the HTTP Request block’s outgoing API response.

To connect a Display block, do the following:

Hover over the HTTP Request block’s Success output port. The pointer changes to a crosshair.
Decide where on the canvas you want to place the Display block and drag the port to that location.
Click Display. If you want to search for the block, enter Display in search.

Run the flow

From the canvas toolbar, click Run.

Send a request flow

Congratulations! You sent a request and displayed the response in a Display block.