Form-data body in Postman

Introduction

Form-data body lets you send data like files and text in a way web servers expect from forms. It helps test how your app handles user input.

When testing file uploads in a web form.

When sending mixed data types like text and images together.

When simulating a user submitting a form with multiple fields.

When API expects multipart/form-data content type.

When testing how backend processes form submissions.

Syntax

Postman

POST /upload HTTP/1.1
Host: example.com
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW

------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="field1"

value1
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="file"; filename="example.txt"
Content-Type: text/plain

(file content here)
------WebKitFormBoundary7MA4YWxkTrZu0gW--

Each part is separated by a boundary string.

Use Content-Disposition to name fields and files.

Examples

Sends a simple text field named 'username' with value 'alice'.

Postman

Key: username
Value: alice
Type: text

Sends a file named 'profile_pic' as part of the form-data.

Postman

Key: profile_pic
Value: (select file)
Type: file

Sends a text field 'bio' with a short description.

Postman

Key: bio
Value: Hello, I am Alice.
Type: text

Sample Program

This test sends a form with a text field 'name' and a file 'avatar'. It checks if the server accepts both correctly.

Postman

POST /submit HTTP/1.1
Host: api.example.com
Content-Type: multipart/form-data; boundary=----Boundary123

------Boundary123
Content-Disposition: form-data; name="name"

John Doe
------Boundary123
Content-Disposition: form-data; name="avatar"; filename="avatar.png"
Content-Type: image/png

(binary data here)
------Boundary123--

Important Notes

Always set the correct Content-Type header with boundary.

Use Postman's form-data tab to add fields easily without manual formatting.

Files must be selected properly to test upload functionality.

Summary

Form-data body is used to send files and text like a real form.

It uses boundaries to separate parts of data.

Postman helps create form-data requests easily for testing APIs.

Practice

1. What is the main purpose of using form-data body in Postman?

easy

A. To send only JSON data

B. To send only URL encoded data

C. To send raw binary data without boundaries

D. To send files and text data like a real HTML form

Solution

1. Step 1: Understand form-data usage

   Form-data body is designed to send files and text fields together, mimicking how HTML forms submit data.

2. Step 2: Compare with other body types

   JSON and URL encoded bodies do not support file uploads or mixed data as form-data does.

3. Final Answer:

   To send files and text data like a real HTML form -> Option D

4. Quick Check:

   Form-data = files + text [OK]

Hint: Form-data sends files and text like a real form [OK]

Common Mistakes:

• Confusing form-data with raw JSON
• Thinking form-data cannot send files
• Mixing form-data with URL encoded body

2. Which of the following is the correct way to add a file in Postman's form-data body?

easy

A. Set key type to File and select the file from your system

B. Set key type to Text and enter file path

C. Set key type to Raw and paste file content

D. Set key type to JSON and upload file

Solution

1. Step 1: Identify file upload method in Postman

   Postman requires setting the key type to File to upload a file from your system in form-data.

2. Step 2: Eliminate incorrect options

   Text type is for plain text, Raw is for raw data input, JSON is a data format, none upload files directly.

3. Final Answer:

   Set key type to File and select the file from your system -> Option A

4. Quick Check:

   File upload = key type File [OK]

Hint: Use 'File' type key to upload files in form-data [OK]

Common Mistakes:

• Choosing Text type for file upload
• Trying to upload files in Raw body
• Confusing JSON body with form-data

3. Given this form-data body in Postman:

Key: username, Value: alice, Type: Text
Key: avatar, Value: (file selected), Type: File

What will the Content-Type header look like when the request is sent?

medium

A. application/json

B. multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW

C. application/x-www-form-urlencoded

D. text/plain

Solution

1. Step 1: Recognize form-data Content-Type

   Form-data requests use multipart/form-data with a boundary string to separate parts.

2. Step 2: Match Content-Type to form-data

   Options B, C, and D are for JSON, URL encoded, and plain text respectively, not for form-data with files.

3. Final Answer:

   multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW -> Option B

4. Quick Check:

   Form-data uses multipart/form-data with boundary [OK]

Hint: Form-data always uses multipart/form-data with boundary [OK]

Common Mistakes:

• Assuming JSON Content-Type for form-data
• Confusing URL encoded with form-data
• Ignoring boundary parameter in Content-Type

4. You created a form-data request in Postman but the server reports missing file data. What is the most likely mistake?

medium

A. You set the file key type as Text instead of File

B. You forgot to add the Authorization header

C. You used raw JSON body instead of form-data

D. You did not select any file for the file key

Solution

1. Step 1: Analyze the missing file data issue

   If the server says file data is missing, the file was not sent properly.

2. Step 2: Identify common form-data mistakes

   Setting file key as Text sends file path as text, not the file content. Selecting no file also causes missing data but is less common if user intended to upload.

3. Final Answer:

   You set the file key type as Text instead of File -> Option A

4. Quick Check:

   File key must be type File [OK]

Hint: File keys must be type File, not Text [OK]

Common Mistakes:

• Using Text type for file keys
• Not selecting a file for upload
• Confusing body types (raw vs form-data)

5. You want to send a form-data request with multiple text fields and two files named photo.jpg and resume.pdf. How should you configure the form-data body in Postman to correctly send all data?

hard

A. Add all keys as File type and upload files only, omit text fields

B. Add all keys as Text type and paste file paths as values

C. Add keys for text fields as Text type, add keys for files as File type, select files from system

D. Use raw JSON body with base64 encoded files and text fields

Solution

1. Step 1: Understand form-data mixed data requirements

   Form-data supports sending text fields and files together by setting key types accordingly.

2. Step 2: Configure keys properly in Postman

   Text fields must be type Text with their values; files must be type File with selected files uploaded.

3. Final Answer:

   Add keys for text fields as Text type, add keys for files as File type, select files from system -> Option C

4. Quick Check:

   Text keys = Text type, file keys = File type [OK]

Hint: Text fields use Text type; files use File type in form-data [OK]

Common Mistakes:

• Uploading files as text values
• Omitting text fields when files are present
• Using raw JSON instead of form-data for files