Send URL-encoded or form data to flows

The Request block can get input data for your flow from a scenario. That enables you to test the flow locally. This topic explains how to create scenarios for Request blocks in flows whose HTTP request bodies need to be formatted as form-data or x-www-form-urlencoded data. For flows whose request bodies will only require plain JSON, skip this topic and follow the Request block setup instruction instead.

Create and deploy the flow

1. Create a deployable flow and include an HTTP Request block with an HTTP request.

2. Click Deploy and enter a URL.

3. Click Deploy.

4. Click Current, then click Open in HTTP request to open the HTTP request editor.

Edit the request

1. In the HTTP request editor, select the POST request method.

2. (Optional) Configure parameters, authorization, headers, scripts, and settings as desired.

3. Configure the request body in the Body tab. Choose one of the following two options, depending on whether your flow will require its HTTP request body to be formatted as x-www-form-urlencoded or form-data:

   • Option one: Select x-www-form-urlencoded, then enter the keys and example values.

   • Option two: Select form-data, then enter the keys and example values for your form fields.

   Form data values are of type Text by default, but you can alternatively select File, add a file. If the file hasn’t been uploaded to the Postman cloud yet, click Upload file to team to make it available to your teammates.

4. Save and send the request.

5. Assuming that the flow responds with 200 OK, click Home > Analytics.

Obtain the request body

1. In the Flow column, click the name of the flow you’re sending requests to, to open its details at right.

2. Under Run Logs, click Request to reveal details. In the Body section, click Copy to copy the request body.

3. Click Open flow to return to your flow.

Work with the request body

1. In your flow, create a scenario, and in the Body field, paste the request body that you copied while in the request editor.

2. Save and run the scenario.

3. Click the Body port of the Request block to open the block footer, and verify that the block emitted the correct request body, headers, and parameters.

4. Based on the correctly formed request body that’s available in the block footer, add blocks to your flow to process the request body data as desired.