Form-data body in Postman - Build an Automation Script

Send POST request with form-data body and verify response

Preconditions (3)

Step 1: Open Postman and create a new POST request

Step 2: Set the request URL to https://api.example.com/upload

Step 3: Select 'Body' tab and choose 'form-data' option

Step 4: Add key 'username' with value 'testuser'

Step 5: Add key 'file' and upload a sample file (e.g., sample.txt)

Step 6: Send the request

Step 7: Observe the response status code and body

✅ Expected Result: Response status code is 200 OK and response body contains confirmation message 'Upload successful for user testuser'

Automation Requirements - Postman (using pm scripting)

Assertions Needed:

Verify response status code is 200

Verify response body contains 'Upload successful for user testuser'

Best Practices:

Use pm.test and pm.response for assertions

Use descriptive test names

Keep test scripts simple and readable

Automated Solution

Postman

pm.test('Status code is 200', () => {
    pm.response.to.have.status(200);
});

pm.test('Response body contains confirmation message', () => {
    const responseJson = pm.response.json();
    pm.expect(responseJson.message).to.eql('Upload successful for user testuser');
});

The first test checks that the response status code is exactly 200, which means the request was successful.

The second test parses the response body as JSON and verifies that the 'message' field matches the expected confirmation text.

Using pm.test groups assertions with clear names, making test results easy to understand.

Common Mistakes - 3 Pitfalls

{'mistake': "Not setting the request body type to 'form-data' in Postman", 'why_bad': 'The API expects form-data format; sending raw JSON or other formats will cause the request to fail or behave unexpectedly.', 'correct_approach': "Always select 'form-data' in the Body tab when the API requires form-data."}

{'mistake': 'Not uploading the file correctly or forgetting to add the file key', 'why_bad': 'The API will not receive the file, causing the upload to fail or return an error.', 'correct_approach': "Add a key with type 'File' in form-data and upload the correct file."}

Using incorrect assertion syntax in Postman scripts

Bonus Challenge

Now add data-driven testing with 3 different usernames and files

Show Hint

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