The HTTP Request block

The HTTP Request block runs an HTTP request that you select from a collection and sends the result from its output port.

Input

Send - If you connect another block to this input port, that block triggers the HTTP Request block to run. This connection is optional. The HTTP Request block will run when the flow runs, even if this port isn't connected to another block.

Outputs

Success - Sends the response of a successful API request. A successful request has a 2xx HTTP status code.

Fail - Sends the response of an unsuccessful API request. An unsuccessful request has an HTTP status code other than 2xx.

Setup

Find or create new request - Select this dropdown list to see all the collections in your workspace. Select a collection, then select a request or Create a new request. If there are no collections in the workspace, some introductory requests will appear that you can choose from to get started.

Variables - If the selected request has one or more variables, they'll be listed here. You can assign a value to a variable by connecting another block's output port to the variable's input port. You can also assign a value to a variable by inserting a data block with Add data blocks. If your request uses environment variables, you can select the environment from the Add environment dropdown list.

Create a new request

You can create a request from the HTTP Request block using the Postman Flows request editor, where you can select a method, enter a URL, and edit parameters, headers, and the request's body.

To create a request in the HTTP Request block, do the following:

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

2. 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.

   

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

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

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

6. Select Save.

Specify how to parse the response

The HTTP Request block can parse its response as JSON, XML, HTML, or text.

To choose how to parse the response, do the following:

1. Select the HTTP Request block, then select Additional Settings.

2. Select Parse Response.

3. Select a format from the dropdown list. You can also select Auto to let the HTTP Request block decide how to parse the response. The default setting is Auto.

Related blocks

The Select and Evaluate blocks are often connected to the HTTP Request block. The Select block is useful for extracting specific information from a response. The Evaluate block is useful for transforming response data and creating conditions to route data in your flow based on a response.

• Select
• Evaluate