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 and your new request 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:

1. Choose an existing workspace or create a new one.
2. From the Postman sidebar, select Flows.
3. Select Create a new Flow > Create new Flow.
4. Enter a name. For example, enter Create a request.
5. Select the Return or Enter key.

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:

1. From the Postman sidebar, select Flows.

2. Select your new flow.

3. Select Send a request.

   

4. Select Find or create new request. The collections in your workspace will appear in a dropdown list.

5. Select a collection and select Create a new request. If you don't have any collections, select Create a new request. The Postman Flows request editor opens.

   

6. In the request editor, select a method from the dropdown list and enter a URL.

7. (Optional) Select and edit the request's name.

8. (Optional) Select and edit the request's parameters, headers, and body.

9. Select Save.

To edit a request in an existing HTTP Request block, select 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:

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

Run the flow

From the canvas toolbar, select Run.

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