Skip to content
Postman API Testing Tips

How To Send Put Request Using Postman

API Testing Blog

Understanding PUT Requests

The PUT method is a fundamental HTTP method used in RESTful APIs for updating existing resources. It’s a powerful tool for maintaining data integrity and ensuring your API behaves predictably.

How to Send a PUT Request Using Postman: A Step-by-Step Guide

Here’s a comprehensive guide on how to send PUT requests using Postman, along with illustrative examples and best practices.

1. Setting Up Your Request

  • Open Postman: Launch the Postman app or access it through your web browser.
  • Create a New Request: Click on the “New” button and select “Request.”
  • Choose the PUT Method: In the top navigation bar, select “PUT” from the dropdown.

2. Specifying Your API Endpoint

  • Enter the URL: In the “Enter request URL” field, type the complete API endpoint for the resource you want to update.
  • Example: Suppose you want to update a user with the ID “123” in your API. The URL might look like this: https://api.example.com/users/123

3. Adding Request Headers

  • Authorization: If your API requires authorization, add the necessary headers in the “Headers” tab.
  • Content-Type: Specify the data format you’re sending. Common values are:
    • application/json: For JSON data
    • application/xml: For XML data
  • Example: 
    Content-Type: application/json
    Authorization: Bearer your_token

4. Crafting the Request Body

  • Provide the Update Data: In the “Body” tab, enter the data you want to use to update the resource.
  • JSON Body: If you’re sending JSON data, select the “raw” tab and choose “JSON” from the dropdown. Here’s an example of updating a user’s name and email: 
    {
        "name": "Updated Name",
        "email": "updated.email@example.com"
    }
  • Other Formats: You can use the “form-data,” “x-www-form-urlencoded,” or “binary” tabs for alternative data formats.

5. Sending the PUT Request

  • Click “Send”: Once you’ve filled in the necessary details, hit the “Send” button to execute the PUT request.

6. Reviewing the Response

  • Inspect the Status Code: Look for a successful status code like 200 (OK) or 204 (No Content) to confirm the update was successful.
  • Examine the Response Body: If the API returns a response body, review its content to ensure the update was performed as expected.

Practical Example: Updating a User Profile

Let’s assume you want to update a user’s profile in an API. Here’s a practical example of how to do this with Postman:

  1. API Endpoint: https://api.example.com/users/123
  2. Request Headers: 
    Content-Type: application/json
    Authorization: Bearer your_token
  3. Request Body: 
    {
        "name": "Updated Name",
        "email": "updated.email@example.com"
    }

By following these steps and making adjustments according to your specific API requirements, you can efficiently send PUT requests using Postman.

Different Ways to Send PUT Requests

1. Using Postman’s GUI

This is the most intuitive and user-friendly approach. Postman’s graphical interface simplifies the process of sending PUT requests with its pre-built features.

2. Through Postman Collections

For complex workflows involving multiple PUT requests, you can group them into Postman Collections. Collections allow you to organize, test, document, and share your API requests.

3. Utilizing Postman Scripts

For greater control and automation, you can use Postman’s scripting capabilities. You can write scripts to dynamically generate request bodies, handle responses, and integrate with other tools.

4. Sending PUT Requests From the Command Line

If you prefer command-line tools, tools like curl or Node.js libraries like axios enable you to send PUT requests directly from your terminal.

Best Practices for PUT Requests

  • Idempotency: Always ensure your PUT requests are idempotent. This means that executing the same PUT request multiple times should result in the same outcome on the server (ideally, only one successful update).
  • Data Validation: Handle potential errors by validating the data you’re sending in the request body.
  • Versioning: If you are updating an object with multiple versions, clearly indicate the version you’re working with.

By mastering the art of sending PUT requests with Postman, you’ll gain invaluable control over your API workflows and ensure the accuracy and integrity of your data.

API Testing Blog