@PostMapping Spring Boot Example

In this post, we will see what is @PostMapping annotation and how to use it with an example.

What is @PostMapping?

@PostMapping annotation maps HTTP POST requests onto specific handler methods. It is a composed annotation that acts as a shortcut for @RequestMapping(method = RequestMethod.POST).
@PostMapping - shortcut for @RequestMapping(method = RequestMethod.POST)
Why Opt for @PostMapping? 

Clarity: With its precise naming, @PostMapping instantly indicates the HTTP method in play, eliminating any potential confusion. 

Simplicity: Instead of the somewhat lengthy @RequestMapping(value="/endpoint", method=RequestMethod.POST), you can use the more succinct @PostMapping("/endpoint").

Consistency with Other HTTP Methods: Alongside @GetMapping, Spring offers annotations like @PutMapping, @DeleteMapping, and so forth, fostering consistency across controller methods. 

A Practical @PostMapping Example 

Let's develop a straightforward Spring Boot application showcasing the @PostMapping annotation. 

Project Initialization 

Kick-off by creating a new Spring Boot project through the Spring Initializer or your preferred IDE. 

The Entity 

Suppose we're creating an API for user management. We'll utilize a basic User class.
public class User {
    private Long id;
    private String name;
    private String email;

    // Constructors, getters, setters, etc.

The Controller 

Next, we'll create a UserController to manage incoming HTTP POST requests.
public class UserController {

    private List<User> users = new ArrayList<>();

    public User addUser(@RequestBody User user) {
        user.setId((long) (users.size() + 1)); // Simple ID generation
        return user;
A few points to note: 
  • @PostMapping without any path will map to the base URL (/api/users in this case). 
  • The @RequestBody annotation is pivotal. It signals to Spring that the method parameter user should be constructed from the body of the incoming request. 

Running the Application 

Once the application is set up and running, making a POST request to /api/users with a user object in the request body will result in the user being added to the list. The server will return the user object with the ID set. 


@PostMapping offers a streamlined way to manage HTTP POST requests in Spring, boosting code readability and reducing verbosity. When creating RESTful services with Spring Boot, embracing @PostMapping ensures that POST request management remains a breeze!