Skip to content
Postman API Testing Tips

How To Use Post Method In Postman

API Testing Blog

Understanding the POST Method

The POST method is a fundamental HTTP request method used for sending data to a server to create or update resources. It’s distinct from the GET method, which is primarily used for retrieving data. Let’s delve into the practical aspects of using the POST method in Postman for API testing.

Creating a POST Request in Postman

  1. Open Postman: Launch the Postman application.
  2. Create a New Request: Click the “New” button in the top left corner and select “Request.”
  3. Select the POST Method: In the request builder, choose “POST” from the HTTP methods dropdown.
  4. Enter the API Endpoint: In the “Enter request URL” field, provide the URL of the API endpoint you want to interact with. For instance, if you are creating a new user, the URL might be https://api.example.com/users.
  5. Set Headers: If the API requires specific headers, such as authorization or content type, add them in the “Headers” tab.
  6. Add the Request Body: This is where you define the data you want to send to the server. In the “Body” tab, select the appropriate format:
    • Form data: Suitable for sending key-value pairs (e.g., username, password).
    • x-www-form-urlencoded: Similar to form data but encodes the data in a URL-friendly format.
    • Raw: Allows you to send raw data in various formats, such as JSON, XML, or text.
    • Binary: For sending files.

Sending a POST Request with JSON Data

Let’s consider a practical example of creating a new user using the POST method and sending data in JSON format.

Scenario: You want to create a new user with the following details:

Steps:

  1. Request URL: https://api.example.com/users
  2. Headers:
    • Content-Type: application/json
  3. Body (Raw): 
    {
      "username": "testuser",
      "email": "testuser@example.com"
    }
  4. Send the Request: Click the “Send” button.

Response: The server will respond with a status code indicating the success or failure of the request. The response body might contain details about the newly created user or any errors encountered.

Verifying the Response

After sending the POST request, Postman displays the response in a separate tab. This tab contains the following information:

  • Status Code: A numerical code indicating the success (e.g., 201 Created) or failure (e.g., 400 Bad Request) of the request.
  • Headers: Headers sent back by the server.
  • Body: The actual data returned by the server.

You can use Postman’s tools to validate the response:

  • Validation: Use assertions to check if the expected data is present in the response.
  • Pretty Print: Format the response data for easier readability.

Using Environment Variables for Dynamic Requests

In real-world scenarios, you might need to use dynamic values in your POST requests, such as different usernames or API endpoints. Postman environment variables come in handy for this.

Steps:

  1. Create an Environment: Go to “Manage Environments” (gear icon) and create a new environment.
  2. Add Variables: Add variables relevant to your API testing. For example:
    • api_base_url: https://api.example.com
    • username: testuser
  3. Use Variables in the Request: In the request builder, use the syntax {{environment_variable_name}} to reference the values. For example:
    • Request URL: {{api_base_url}}/users

Other Considerations

  • Authorization: If the API requires authentication, you can add authorization details in the “Authorization” tab of Postman.
  • File Uploads: Use the “Binary” body format to send files as part of your POST request.
  • Error Handling: Thoroughly test and handle potential errors returned by the server using assertions and appropriate logic in your tests.

By mastering the use of the POST method in Postman, you gain a powerful tool for creating, updating, and testing API resources.

API Testing Blog