? HTTP 201 Created

? Quick Overview

The 201 Created status code indicates that a request has been successfully processed and resulted in the creation of a new resource on the server. It is commonly returned after successful POST requests in RESTful APIs.

? Key Concepts

• Belongs to the 2xx Success HTTP status code family
• Confirms that a new resource was created
• Usually includes a Location header pointing to the new resource
• Most commonly used with POST requests

? Syntax / Theory

When a server creates a new resource, it responds with status code 201. The response body may include details of the created resource.

? Code Example(s)

// Express.js route that returns HTTP 201 when a resource is created
app.post("/users", (req, res) => {
  const user = req.body;
  res.status(201).json({
    message: "User created successfully",
    data: user
  });
});

? Live Output / Explanation

? Interactive Example

Below is a simulated API environment. Enter a name and click "Create User" to simulate a POST request and see the 201 Created response.

// Simulated Client Request
const createUser = async (name) => {
  console.log("POST /users", { name });
  
  // Simulate Server Delay
  setTimeout(() => {
    return {
      status: 201,
      statusText: "Created",
      body: { id: 123, name: name, createdAt: new Date() }
    };
  }, 1000);
};

? Use Cases

• User registration systems
• Creating orders in e-commerce applications
• Uploading files or media records
• Adding new database records via APIs