Skip to content
Postman API Testing Tips

Can I Push Multiple Objects Using Postman

API Testing Blog

Can I Send Multiple Objects in a Single Request with Postman?

Postman is a versatile tool for testing APIs, and it definitely allows you to send multiple objects in a single request. Here’s how you can achieve this:

Sending Multiple Objects within a JSON Body

One of the most common scenarios is sending multiple objects as the body content of a POST request. This is especially useful for creating or updating multiple resources in a single API call.

Example: Creating Multiple Users

Let’s assume you have an API endpoint /users that accepts an array of user objects in the request body.

Step 1: Define User Object Structure

First, you need to define the structure of a single user object. This is often done in a JSON schema.

{
  "firstName": "string",
  "lastName": "string",
  "email": "string",
  "age": "integer"
}

Step 2: Create the Request Body

Create a JSON array containing multiple user objects.

[
  {
    "firstName": "John",
    "lastName": "Doe",
    "email": "john.doe@example.com",
    "age": 30
  },
  {
    "firstName": "Jane",
    "lastName": "Doe",
    "email": "jane.doe@example.com",
    "age": 25
  }
]

Step 3: Configure the Postman Request

  1. Open Postman and create a new POST request.
  2. Set the URL to /users.
  3. In the Body tab, choose “raw” and select “JSON” as the format.
  4. Paste the JSON array into the body field.

Step 4: Send the Request

Click the “Send” button to execute the request. The API will process both user objects in a single transaction.

Sending Multiple Objects as Query Parameters

You can also send multiple objects as query parameters in your request. This method is often used to filter or manipulate data based on multiple criteria.

Example: Filtering Products by Multiple Categories

Let’s say you have an API endpoint /products that allows you to filter products by category using query parameters.

Step 1: Define Category Structure

Assuming you have a list of categories represented by strings.

Step 2: Construct the Query Parameter String

Create a query string that includes multiple category values.

?category[]=category1&category[]=category2&category[]=category3

Step 3: Configure the Postman Request

  1. Open Postman and create a new GET request.
  2. Set the URL to /products.
  3. Add the query parameters to the URL.
  4. Set the ‘params’ section in the Postman interface to send multiple values for the category parameter.

Step 4: Send the Request

Click the “Send” button. The API will retrieve products that belong to all the specified categories.

Sending Multiple Objects with a Form Data Request

When sending files or data in a more traditional form-like structure, you can use Postman’s form data option. This method allows you to send multiple objects as individual keys in the form data.

Example: Uploading Multiple Images

Consider an API endpoint /uploads that accepts multiple images through a form data request.

Step 1: Configure the Postman Request

  1. Open Postman and create a new POST request.
  2. Set the URL to /uploads.
  3. In the Body tab, select “form-data”.
  4. Add multiple key-value pairs, where each key represents an image, and the value is the file path to the image on your local machine.

Step 2: Send the Request

Click the “Send” button to send the multiple image files in a single request.

Sending Multiple Objects with a Multipart/Mixed Request

For even more complex scenarios involving various data types, you can use Postman’s Multipart/Mixed option. This is particularly useful when you need to send both data and files in the same request.

Example: Sending User Data and an Image

Assume you have an API endpoint /users that allows you to create a new user, including uploading a profile image.

Step 1: Configure the Postman Request

  1. Open Postman and create a new POST request.
  2. Set the URL to /users.
  3. In the Body tab, select “multipart/mixed”.
  4. Add a new “form-data” item for the user data (as a JSON string).
  5. Add another “form-data” item for the profile image, selecting the file from your local machine.

Step 2: Send the Request

Click the “Send” button. The API will receive both the user data and the profile image in a single transaction.

Conclusion

Postman empowers you to send various types of data in single requests, making it a powerful tool for testing APIs. The choice of method depends on the specific API you’re interacting with and the type of data you need to send. Remember to always refer to the API documentation to understand the expected format and structure of the request.

API Testing Blog