How to upload a file with Postman

When you’re developing a web API with file uploading, you can use Postman to send files in test requests. This simplifies development because you don’t have to write your own client-side code for sending the test requests.

In this article, I’ll show how to upload a file with Postman by posting a file in a multipart/form-data request.

1 – Create a POST request

In Postman, create a new request by clicking the plus (+) button:

Postman - Red arrow pointing to the plus (+) button with text "Click to create a new request"

Set the method to POST, and fill in the request URL:

Postman - with the method dropdown set to POST, and the request url field set to https://localhost:12345/files/

In this example, I’m testing a web API that’s running locally.

2 – Add a file as form data

In the Body tab, select the form-data option. Then hover your mouse over the row so you can see a dropdown appear that says Text. Click this dropdown and set it to File.

Postman - Body tab with the form-data selected (text pointing to it says "This is multipart/form-data"). Shows the Text dropdown on the right-side of the Key column in the first row. Clicking this shows a dropdown with two options: Text, File. Set it to File.

Fill in the key name. If the web API is receiving the file with a parameter / property, then make sure this key name matches the parameter name. Finally, click the Select Files button (the name may be different depending on which version of Postman you’re using):

Postman - Shows the key column with value "file" (matches the web API's file parameter name). Shows an arrow pointing to the Select Files button.

Clicking Select Files will open a file selection dialog window. Select one or more files. Now you’ll see the selected filename(s) in the Value column:

Postman - Value column showing the filename - class-hierarchy-diagram.png

3 – Send the request

Click the Send button to send the request.

This sends the following multipart/form-data request:

POST /files/
Content-Type: multipart/form-data; boundary=--------------------------569733738458136444864833
Content-Length: 7265
Content-Disposition: form-data; name="file"; filename="class-hierarchy-diagram.png"
Content-Type: image/png

<class-hiearchy-diagram.png bytes>
----------------------------569733738458136444864833--Code language: plaintext (plaintext)

Note: Excluded irrelevant headers for brevity.

In this example, the web API returns the following response:

Content-Type: text/plain
Body: Saved file class-hierarchy-diagram.png with size in bytes 7041Code language: plaintext (plaintext)

2 thoughts on “How to upload a file with Postman”

  1. This is a great explanation, but when i send my file i get a list of all the files within that locations instead of “Saved my file”?

    So what am I doing wrong?

    POST web-api-url

    Body: form-data

    • Hi,

      The response you get back is controlled by the web API you’re sending requests to. In the example, I’m sending requests to my own web API that’s returning the “Saved my file…” response (ref: how to receive a file in a web API)

      It sounds like whatever web API you’re sending files to is coded to return the list of file names.


Leave a Comment