Readplace

201 Created - HTTP | MDN

MDN Web Docs ~1 min read
View original
  • best
Summary (TL;DR)
The HTTP 201 Created status code indicates a request succeeded and created a new resource. The response includes a Location header pointing to the resource's new URI. An example shows a POST to /users returning 201 with a user object and the new location.

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"
  }
}

Specifications

Specification
HTTP Semantics
# status.201

See also

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on by MDN contributors.