Skip to content
Postman API Testing Tips

How To Use Postman Post Method

API Testing Blog

Understanding the POST Method

The POST method in HTTP is used to send data to a server to create or update a resource on the server. This is in contrast to the GET method, which is used to retrieve data from a server.

POST requests are typically used for actions like:

  • Creating new data (e.g., creating a new user account, adding a product to a cart)
  • Updating existing data (e.g., updating a user’s profile, changing a product’s price)
  • Sending form data

How to Use Postman POST Method: A Step-by-Step Guide

1. Create a New Request

  • Open Postman and click on “New” to create a new request.
  • In the “Request URL” field, enter the API endpoint you want to target.
  • Select “POST” from the dropdown menu in the request type section.

2. Set Headers

  • Click on the “Headers” tab.
  • For the Content-Type header, specify the format of the data you’re sending. For JSON, use application/json. You may need to include other headers depending on the API requirements.

3. Prepare Your Body

  • Click on the “Body” tab.
  • Select “raw” as your data format.
  • Select “JSON” as your syntax highlighting if your data is in JSON format.
  • Paste your JSON data into the body field.

Example: Creating a New User

{
  "username": "john.doe",
  "email": "john.doe@example.com",
  "password": "P@$$wOrd"
}

4. Send the Request

  • Click “Send.”

5. Analyze the Response

  • The response from the server will appear in the “Body” tab.
  • Review the status code (e.g., 201 Created, 400 Bad Request) and the response body to ensure the request was successful.

Example Successful Response (Status Code 201 Created)

{
  "message": "User created successfully",
  "userId": 1234
}

Using Postman to TEST the POST Method

Let’s say you are building an API for a bookstore. You want to test the endpoint responsible for adding new books to your database.

1. Prepare your Postman request

  • Request URL: https://api.yourbookstore.com/books
  • Method: POST
  • Headers:
    • Content-Type: application/json
  • Body: 
    {
        "title": "The Hitchhiker's Guide to the Galaxy",
        "author": "Douglas Adams",
        "genre": "Science Fiction",
        "price": 10.99
    }

2. Send the request

  • Click “Send.”

3. Analyze the response

  • If the request is successful, you might receive a status code of 201 Created (or another code, depending on your API’s implementation) with a response body that contains information about the newly created book (e.g., its unique ID).

Using Postman’s Variables

You can use variables in Postman to dynamically change the data in your requests. For example, you might want to test creating different users with various usernames and email addresses.

1. Create Environmental Variables

  • Click on the “Environment” tab.
  • Click “Add.”
  • Give your variable a name (e.g., username, email) and assign its value.

2. Use Variables in Your Request

  • In your request body, use the syntax {{variable_name}} to reference your environmental variable.

Example Body with Environmental Variables:

{
  "username": "{{username}}",
  "email": "{{email}}",
  "password": "P@$$wOrd"
}

3. Modify and Send Requests

  • You can easily change the values of your environment variables and send multiple requests with different data.

Handling Error Responses

  • Pay attention to the status code in the response. Common error codes include:
    • 400 Bad Request: The request was invalid.
    • 401 Unauthorized: The user is not authenticated.
    • 403 Forbidden: The user is not authorized to perform the action.
    • 500 Internal Server Error: There was an error on the server side.

Conclusion

Postman is an invaluable tool for testing APIs that use the POST method. By using Postman, you can easily send requests, analyze responses, and handle errors, ultimately ensuring that your API is functioning correctly and meeting your requirements.

API Testing Blog