201 Created - HTTP | MDN

MDN Web Docs 1 min read

6 Aug '26, 18:46current

Summary (TL;DR)

The HTTP 201 Created status code indicates a successful POST request that has created a resource. The response should include a Location header pointing to the new resource's URI. A typical example shows a POST to /users with a JSON body, returning 201 with a message, the created user object (including the new id), and the Location header. This status is part of the HTTP Semantics specification.

Status

http

201 Created

Examples

Receiving a response indicating user creation

Let's assume there's a REST API for managing users with an endpoint at http://example.com/users. In this example, we send a POST request with the following body to create a user:

http

POST /users HTTP/1.1
Host: example.com
Content-Type: application/json

{
  "firstName": "Brian",
  "lastName": "Smith",
  "email": "brian.smith@example.com"
}

After successful user creation, the 201 Created response will look like this:

http

HTTP/1.1 201 Created
Content-Type: application/json
Location: http://example.com/users/123

{
  "message": "New user created",
  "user": {
    "id": 123,
    "firstName": "Brian",
    "lastName": "Smith",
    "email": "brian.smith@example.com"
  }
}